从零搭建一个CLI工具：用Python的Click库

写命令行工具是程序员的基本功。argparse 太原始，Click 让 CLI 开发变得优雅。

安装

pip install click

第一个命令

import click

@click.command()
@click.option("--name", prompt="Your name", help="Who to greet")
def hello(name):
    click.echo(f"Hello {name}!")

if __name__ == "__main__":
    hello()

运行 python hello.py --name World 就能看到输出。

命令组

@click.group()
def cli():
    pass

@cli.command()
@click.argument("filename")
def read(filename):
    click.echo(f"Reading {filename}")

@cli.command()
@click.argument("filename")
@click.option("--force", is_flag=True)
def delete(filename, force):
    if force or click.confirm(f"Delete {filename}?"):
        click.echo(f"Deleted {filename}")

进度条

import time

@cli.command()
def process():
    items = range(100)
    with click.progressbar(items, label="Processing") as bar:
        for item in bar:
            time.sleep(0.02)

彩色输出

click.secho("Success!", fg="green", bold=True)
click.secho("Warning!", fg="yellow")
click.secho("Error!", fg="red", err=True)

打包发布

在 pyproject.toml 中配置：

[project.scripts]
mytool = "mytool.cli:cli"

然后 pip install -e .，就能在终端直接用 mytool 命令了。

推荐组合

• Click + Rich：更漂亮的终端输出
• Click + Typer：用类型注解代替装饰器
• Click + pytest：用 CliRunner 做单元测试

Click 是 Flask 团队出品，API 设计一脉相承的优雅。写 CLI 首选。