Python CLI工具核心是将函数调用转为命令行交互，关键在参数解析（如argparse/click处理sys.argv）、子命令分发（如click.group实现git式多级命令）和I/O控制（如管道支持、错误提示）。
Python CLI 工具的核心原理，本质是把函数调用变成命令行交互——参数解析、子命令分发、输入输出控制这三块搭起来，工具就立住了。不需要框架也能写，但用对工具（如 click 或 argparse）能省掉大量胶水代码，重点是理解它们怎么把 sys.argv 映射成 Python 对象。
参数解析：从 sys.argv 到结构化数据
CLI 的第一关是读懂用户敲的那串字符。比如 python backup.py --src /home/docs --dst /backup -v --exclude *.tmp，系统得识别出这是调用 backup 功能、源路径、目标路径、开启详细模式、排除临时文件。
- argparse 靠显式定义参数类型（store_true、nargs、type=int 等）和动作（append、count），适合教学和轻量脚本；
- click 用装饰器把函数参数直接绑定命令行选项，自动处理类型转换、帮助生成、错误提示，开发体验更顺；
- 别手动切分 sys.argv —— 容易漏空格、引号、转义，也绕过所有校验逻辑。
子命令设计：让工具像 git 一样可扩展
单命令工具（如 ls）简单，但真实项目往往需要多个功能模块，比如 mytool init、mytool run --port 8000、mytool deploy --env prod。这就需要命令分组和嵌套。
- click 支持
@click.group()+@xxx.command()实现多级命令树，每个子命令是独立函数，互不干扰； - argparse 可用
add_subparsers()，但配置稍冗长，尤其带共享参数（如全局 --config）时需额外处理； - 避免把所有逻辑塞进一个 if-elif 链——后期维护成本高，测试难覆盖。
I/O 控制与用户体验细节
CLI 不只是跑通逻辑，还要让人愿意用。比如进度条、颜色提示、错误时给出明确修复建议、支持管道输入（cat data.json | mytool process）。
立即学习“Python免费学习笔记（深入）”；
- 用
sys.stdin.isatty()区分终端直连和管道场景，决定是否显示动画或颜色； - 错误不要只抛 traceback，用 click.echo(f"Error: {e}", err=True) + exit(1) 更友好；
- 大文件处理优先支持流式读取（
for line in sys.stdin），而非一次性 load 全部内容。
实战案例：一个带子命令的日志分析小工具
假设要做一个 logtool：支持 logtool parse --file access.log 提取 IP 和状态码，以及 logtool top --field ip --limit 5 统计高频字段。
- 主入口用
@click.group()； - 两个子命令分别封装解析逻辑和聚合逻辑，各自接收专属参数；
- 共享参数（如 --verbose）挂到 group 上，自动透传给所有子命令；
- 加个
--help自动渲染，再配个简短 usage 示例，新手 30 秒就能上手。
不复杂但容易忽略。真正卡住人的，往往是参数冲突、子命令间状态传递、或者没处理好标准输入重定向。动手写两个小命令，比看十篇原理文档管用。
