明确CLI的核心职责
命令行工具不是功能越多越好，关键在于解决特定场景下的效率问题。比如批量重命名文件、解析日志、生成配置模板——每个工具应聚焦一个清晰目标。设计前先问：用户在什么情境下会输入这个命令？需要几秒内得到结果？是否要支持管道输入或重定向？这些决定了命令结构是否合理、参数是否必要。
用argparse构建可维护的参数体系
Python标准库的argparse足够支撑绝大多数CLI需求，无需过早引入click或typer。重点在于分层组织参数：
- 把必选操作（如
upload、list）设为子命令，避免所有逻辑堆在同一个入口 - 用
add_argument(..., action='store_true')处理开关类选项（如--verbose），不依赖字符串判断 - 对路径、URL等输入参数，用
type=Path或自定义校验函数提前拦截错误，而不是等到执行时才报错 - 通过
epilog和description写清典型用法，help信息本身就是文档
输出设计要兼顾人与程序
终端用户需要简洁明了的提示，脚本调用者依赖稳定格式。一个实用做法是：
Android手机开发课程标准 中文WORD版
下载
本课程在设计上本着懂方法，重应用的总体思路，突出体现职业教育的技能型、应用性特色，着重培养学生的实践应用技能，力求达到理论方法够用，技术技能过硬的目的。 通过本课程的学习，使学生具备Android平台应用开发相关知识、良好的编程习惯和手机应用软件开发的能力，能胜任基于Android平台的手机软件研发等工作任务。感兴趣的朋友可以过来看看
- 默认输出面向人：带颜色（可用rich或colorama）、缩进、进度条
- 加
--json或--quiet切换为机器可读模式：纯JSON或仅返回状态码 - 错误统一走
stderr，正常结果走stdout，方便管道衔接 - 非0退出码只在真正失败时使用，避免把警告也当成错误
测试和分发不能跳过
CLI容易因环境差异出问题，测试要覆盖真实交互链路：
立即学习“Python免费学习笔记（深入）”；
- 用
unittest.mock.patch模拟sys.argv，验证参数解析逻辑 - 对实际执行的命令，用
subprocess.run调用打包后的脚本，检查输出和返回码 - 打包推荐setuptools的
console_scripts入口点，安装后直接运行命令名，不用python -m - 在
pyproject.toml里声明requires-python = ">=3.8"，避免低版本兼容陷阱
