企业官网建设流程全解析

123、click 与 argparse 命令行工具：参数解析、交互式 CLI、自动补全

一个让我熬夜的bug

上周五晚上十一点，我盯着终端里那行报错看了整整二十分钟：

TypeError: __init__() got an unexpected keyword argument 'required'

事情是这样的——我写了一个内部运维工具，需要解析命令行参数。一开始图省事，直接用sys.argv手撕参数解析，结果参数一多代码就变成了意大利面条。同事建议用argparse，我心想标准库嘛，稳得很。结果在定义可选参数时，我习惯性地写了required=True，argparse直接甩了我一脸异常。

后来查文档才发现，argparse的add_argument()里required参数只对可选参数（带--前缀的）有效，对位置参数根本不能这么用。这个坑让我意识到：命令行工具看似简单，但标准库和第三方库的设计哲学差异，足以让一个经验丰富的工程师栽跟头。

今天这篇笔记，我就把click和argparse这两个工具掰开揉碎了讲清楚，重点放在那些文档里不会写、但实战中一定会遇到的细节上。

argparse：标准库的硬核与局限

argparse是Python自带的参数解析模块，优点是不需要额外安装，缺点是API设计得有点“学院派”。先看一个典型场景：