用Typer快速构建Python命令行工具（Python Typer库详细使用教程）

安装 Typer

安装非常简单，只需一条 pip 命令：

pip install typer

注意：Typer 依赖于 click，安装时会自动安装。

第一个 Typer 程序

让我们从一个最简单的例子开始：

import typerapp = typer.Typer()@app.command()def hello(name: str):    typer.echo(f"Hello {name}!")if __name__ == "__main__":    app()

将上述代码保存为 main.py，然后在终端运行：

python main.py hello Alice

输出结果为：

Hello Alice!

是不是很简单？你不需要手动解析命令行参数，Typer 会根据函数签名自动生成 CLI 接口。

参数与选项的区别

在 Typer 中，参数（Arguments） 是位置相关的，而 选项（Options） 通常以 -- 开头，可以有默认值。

import typerapp = typer.Typer()@app.command()def greet(name: str, formal: bool = False):    if formal:        typer.echo(f"Good day, {name}.")    else:        typer.echo(f"Hi {name}!")if __name__ == "__main__":    app()

运行示例：

# 使用默认值python main.py greet Alice# 输出: Hi Alice!# 使用选项python main.py greet --formal Alice# 输出: Good day, Alice.

使用子命令组织复杂工具

当你的 CLI 工具功能越来越多时，可以使用子命令来组织代码：

import typerapp = typer.Typer()users_app = typer.Typer()app.add_typer(users_app, name="users")@users_app.command()def create(username: str):    typer.echo(f"Creating user: {username}")@users_app.command()def delete(username: str):    typer.echo(f"Deleting user: {username}")if __name__ == "__main__":    app()

现在你可以这样使用：

python main.py users create johnpython main.py users delete john

为什么选择 Typer？

相比传统的 argparse 或直接使用 click，Python Typer库 提供了更现代化、更 Pythonic 的方式来开发 命令行工具开发 项目。其核心优势包括：

• 代码即文档：类型提示让参数含义一目了然
• 自动验证：输入不符合类型会报错
• 零配置生成帮助信息（--help）
• 支持异步函数（配合 asyncio）

结语

通过本教程，你应该已经掌握了如何使用 Python CLI框架 Typer 来快速构建功能强大的命令行应用。无论你是初学者还是有经验的开发者，Typer 都能让你的 Typer使用教程 学习过程变得轻松愉快。

赶快动手试试吧！官方文档地址：https://typer.tiangolo.com/