【Python】比较两个cli库：Click vs Typer

Python 中 Click 和 Typer 的比较

Click 和 Typer 是 Python 中两个流行的命令行接口（CLI）库，用于快速构建命令行工具。Click 是成熟的经典库，而 Typer 则是由 FastAPI 作者 Sebastián Ramírez 开发的现代库，直接构建在 Click 之上。

核心差异概述

方面	Click	Typer
发布与维护	2014 年起，由 Pallets 项目维护，成熟稳定	2020 年起，积极维护，继承 Click 的优势并改进
依赖	几乎无外部依赖，轻量	依赖 Click，可选 Rich（用于彩色帮助输出）
代码风格	使用装饰器（如 @click.command()），灵活但稍冗长	利用 Python 类型提示（type hints），代码更简洁现代
自动功能	手动配置帮助、参数类型等	自动生成帮助文档、参数验证、Shell 补全
性能	更快、更轻量（适合资源受限环境，如 Raspberry Pi）	稍慢（因额外层和可选依赖），但日常无明显差异
流行度（2026 年初）	GitHub stars 约 15k+，长期主导市场	已超过 Click，成为 stars 最多的 Python CLI 库
适用场景	需要最大灵活性、自定义行为或轻量部署的复杂 CLI	快速开发、现代 Python 项目（尤其结合 FastAPI）

优点对比

Typer 的优点：
- 代码极简：函数参数直接用类型提示定义 CLI 参数，无需重复声明类型、帮助文本等。
- 自动支持：优秀帮助文档、参数验证、Shell 自动补全（bash/zsh/fish）。
- 开发者友好：与现代 Python（3.7+ 类型提示）完美整合，适合新项目。
- 可混合使用 Click：如果 Typer 不够，可直接访问底层 Click 对象扩展。
Click 的优点：
- 更成熟：生态丰富，许多大型项目（如 Flask CLI）基于它构建。
- 更高性能和更少依赖：适合嵌入式或最小化环境。
- 更强大自定义：支持复杂嵌套命令、插件系统等高级特性。

代码示例对比（简单 CLI：问候命令）

使用 Click：

python 复制代码

import click

@click.command()
@click.option('--name', default='World', help='The person to greet.')
def hello(name):
    """Greet a person."""
    click.echo(f"Hello {name}!")

if __name__ == '__main__':
    hello()

使用 Typer：

python 复制代码

import typer

def hello(name: str = "World"):
    """Greet a person."""
    typer.echo(f"Hello {name}!")

if __name__ == "__main__":
    typer.run(hello)

可见，Typer 代码更短，几乎无需额外配置，就能自动生成 --name 选项和帮助。

哪个更好？

如果你追求简洁、快速开发和现代特性 （尤其项目已用类型提示），推荐 Typer------它是当前最受欢迎的选择。
如果需要极致性能、轻量或高度自定义 ，或项目已基于 Click，推荐 Click。
许多人建议从 Typer 开始，因为它基于 Click，不够用时可无缝回落。

总体而言，Typer 是 Click 的"现代升级版"，在 2025-2026 年已成为许多新 CLI 项目的首选。