1
.
2
├── .python-version
3
├── README.md
4
├── main.py
5
└── pyproject.toml

1
my-cli-project/
2
├── .venv/                  # 虚拟环境 (uv venv 创建, 应被Git忽略)
3
|
4
├── src/                    # 源代码的根目录
5
│   └── my_cli_project/     # 这才是你实际的Python包 (包名通常用下划线)
6
│       ├── __init__.py     # 包初始化文件, 可以为空
7
│       └── main.py         # CLI入口和核心逻辑
8
│
9
├── tests/                  # 存放自动化测试代码的目录，可以没有
10
│   ├── __init__.py         # 标记为包
11
│   └── test_main.py        # 针对 main.py 的测试文件
12
│
13
├── .gitignore              # Git忽略文件配置
14
├── pyproject.toml          # 项目配置文件
15
└── README.md               # 项目说明文档

1
import module
2

3

4
# 实现功能的函数
5
def do_hello(name，flag):
6
    if flag:
7
        print("Hello World!")
8
    else if:
9
      print(f"Hello World! from {name}")
10

11

12
# 主函数
13
def main():
14
    # 1. 创建主解析器
15
    parser = argparse.ArgumentParser(description="A cool CLI application built with argparse.")
16

17
    # 2. 创建子命令解析器
18
    #    这是实现 git <command> 这种模式的关键
19
    subparsers = parser.add_subparsers(dest="command", help="Available commands", required=True)
20

21
    # 3. 创建 'hello' 命令的解析器
22
    parser_greet = subparsers.add_parser("hello", help="Greets someone.")
23
    parser_greet.add_argument(
24
        "--name", # 传参的全称, 实现类似功能: my-cli hello --name lancer_soul
25
        "-n", # 传参的简称，实现类似功能: my-cli hello -n laner_soul
26
        type=str, # 规定传参的类型，默认为str，其他类型需要特殊指定
27
        default="World", # 规定传参默认值
28
        help="The name to greet."
29
    )
30
    parser_greet.add_argument(
31
    "-ignore", "-i", action="store_true", # 代表-i是一个flag，指定该选项为True, 不指定为False, 传入值时会报错
32
        help="ignore --name to print 'Hello World!'"
33
    )
34

35
    # 5. 解析来自终端的参数
36
    args = parser.parse_args()
37

38
    # 6. 根据解析出的命令，调用对应的函数，如果不传入命令，argparse会默认显示帮助
39
    if args.command == "greet":
40
        do_hello(name=args.name, flag=args.ignore)
41

42
if __name__ == "__main__":
43
    main()

1
[build-system]                      # 可以没有，不指定就默认使用setputools
2
requires = ["setuptools"]
3
build-backend = "setuptools.build_meta"
4
[project.scripts]
5
my-cli = "my_cli_project.main:main" # 定义CLI入口，my-cli会使用my_cli_project包main.py中的main函数