用 Click 构建可组合的命令行工具（Python）
Click 是 Python CLI 框架，支持命令嵌套、参数校验与自动帮助生成。本文讲解命令与选项、命令组组合、参数类型验证与上下文传递，打造模块化命令行应用。
直接回答：Click 是 Python 中构建命令行界面的主流框架：装饰器式定义命令、自动参数校验、自动生成帮助文本，并通过命令组（Group）机制让多个子命令像乐高一样组合成层次清晰的 CLI。
为什么是 Click
手写 sys.argv 解析的痛苦每个 Python 开发者都经历过；argparse 够用但啰嗦。Click 用装饰器把"命令长什么样"写在函数头顶，参数类型、默认值、帮助文案一步到位，还自带彩色输出、确认提示、进度条等贴心工具。
快速上手
pip install click
import click
@click.command()
@click.option("--count", default=1, help="问候次数")
@click.argument("name")
def hello(count, name):
for _ in range(count):
click.echo(f"你好, {name}!")
if __name__ == "__main__":
hello()
python hello.py --count 2 世界
python hello.py --help # 自动生成的帮助
@click.argument：位置参数（默认必填，也可配置为可选）；@click.option：可选参数，支持默认值、短选项、提示输入（prompt=True）、隐藏输入（密码场景）。
命令组：可组合的核心
@click.group()
def cli():
"""我的运维工具箱"""
@cli.command()
@click.argument("host")
def ping(host):
"""检查主机连通性"""
click.echo(f"PING {host} ...")
@cli.command()
@click.option("--env", type=click.Choice(["dev", "prod"]), default="dev")
def deploy(env):
"""部署到指定环境"""
click.echo(f"部署到 {env}")
if __name__ == "__main__":
cli()
保存为 tool.py 后得到 python tool.py ping host1 / python tool.py deploy --env prod 这样的子命令结构。命令组还能嵌套（group 里挂 group），大型 CLI 如 git remote add 的层次感就是这么来的。
参数类型与校验
Click 内置丰富类型：int、float、Path(exists=True)（文件必须存在）、Choice（枚举值）、DateTime、File 等。校验在解析阶段完成，失败给出友好报错，业务函数拿到的就是干净的类型化数据。自定义校验可以实现 click.ParamType 子类。
上下文传递
子命令之间共享状态（如全局 verbose、配置文件）用 click.Context：
@click.group()
@click.option("--verbose", is_flag=True)
@click.pass_context
def cli(ctx, verbose):
ctx.obj = {"verbose": verbose}
@cli.command()
@click.pass_context
def status(ctx):
if ctx.obj["verbose"]:
click.echo("详细模式开启")
ctx.obj 是贯穿整条命令链的共享口袋。
常见问题（FAQ）
Q：Click 和 Typer、argparse 怎么选？
A：argparse 零依赖但啰嗦；Click 成熟稳定、生态广；Typer 基于 Click、用类型注解写 CLI 更现代。新项目喜欢类型注解选 Typer，求稳选 Click。
Q：怎么把 CLI 打包成系统命令？
A：在 pyproject.toml 里配置 [project.scripts] 入口点，pip 安装后自动生成可执行命令。
Q：子命令多了文件怎么组织？
A：每个命令组一个模块，主入口只做 import 和挂载。Click 的惰性加载还能避免启动时 import 全部模块。
官方参考
本文基于官方文档整理，未进行运行时或性能测试。示例中的业务函数、数据模型和部署地址需结合项目补全；局部片段不等同于完整生产应用。
