专业级命令行工具应以用户直觉为核心：用子命令组织逻辑（如mytool deploy/logs/reset），参数命名遵循Unix风格（--output-dir、-v），主动校验并提供明确错误提示，支持配置文件、环境变量与命令行三级优先级叠加。
用 argparse 设计专业级命令行工具，核心不是堆功能，而是让使用者“不用查文档就能猜对怎么用”——这靠清晰的结构、一致的约定和恰到好处的反馈。
用子命令组织逻辑，别塞进一堆孤立参数
当功能超过 3–4 个，硬塞在同一个命令下会迅速失控。比如部署服务、查看日志、重置配置，应该拆成 mytool deploy、mytool logs、mytool reset。
做法是创建 subparsers，为每个子命令单独定义参数集，互不干扰：
subparsers = parser.add_subparsers(dest='command', required=True)
deploy = subparsers.add_parser('deploy', help='Deploy service to target env')
deploy.add_argument('--env', choices=['dev', 'staging', 'prod'], required=True)
deploy.add_argument('--dry-run', action='store_true')
logs = subparsers.add_parser('logs', help='Fetch recent logs')
logs.add_argument('--lines', type=int, default=20)
logs.add_argument('--follow', '-f', action='store_true')
这样用户运行 mytool --help 看主菜单，mytool deploy --help 只看到部署相关选项，信息密度合理，也方便后期模块化维护。
立即学习“Python免费学习笔记（深入）”；
参数命名遵循 Unix 风格，兼顾可读与简洁
长选项用中划线分隔（--output-dir），不写下划线或驼峰；短选项选单字母，优先保留通用含义（-v 表示 verbose，-h 和 --help 自动存在，别覆盖）。
避免歧义：比如 --force 比 --yes 更通用；--config-file 比 --cfg 更明确，但可同时提供短选项 -c。
对布尔开关，推荐用 action='store_true' 或 action='store_false'，而不是 type=bool（后者会把任何非空字符串转成 True，极易出错）。
主动校验 + 友好报错，别等运行时崩给你看
argparse 支持在解析阶段就拦截明显错误。例如：
- 路径参数存在性检查：
type=argparse.FileType('r')或自定义type函数抛出argparse.ArgumentTypeError - 数值范围限制：
choices=[1, 5, 10]或用type函数做区间判断 - 互斥逻辑：
add_mutually_exclusive_group()确保--verbose和--quiet不会同时出现
报错信息要具体。默认错误只说“invalid choice”，改成：
def valid_port(value):
ivalue = int(value)
if not (1024 <= ivalue <= 65535):
raise argparse.ArgumentTypeError(f"Port must be between 1024 and 65535, got {value}")
return ivalue
parser.add_argument('--port', type=valid_port, default=8000)
支持配置文件 + 环境变量 + 命令行，按优先级叠加
专业工具必须尊重用户习惯：有人爱写 config.yaml，有人习惯 export MYTOOL_ENV=prod，命令行参数应始终拥有最高优先级。
argparse 本身不直接支持配置文件，但可在解析前手动加载并合并：
- 先用
parse_known_args()提取--config参数 - 读取配置文件（如 YAML/JSON），转成字典
- 再用
os.environ覆盖（按需转换类型） - 最后调用
parse_args()，命令行参数自动覆盖前面所有值
关键点：不要隐藏这个流程。在 --help 中注明 “Config loaded from --config, then environment variables prefixed with MYTOOL_”。
