✅ 极简心智 — 函数 + 类型注解就是全部，不用记一堆 add_argument 参数。

📖 帮助自动生成 — 函数的 docstring、参数 help 自动变成专业帮助文档，连配色都帮你做好了。

🧱 底层稳健 — 它构建在超成熟的 click 之上，兼容 click 生态，稳得一批。

pip install typer

import typer  def main(name: str):     print(f"Hello {name}")  if __name__ == "__main__":     typer.run(main)

💡 心智模型：Typer 把"没默认值的参数"当成必填位置参数，"有默认值的参数"自动升级成 --选项。类型注解决定接受什么类型，str 收字符串、int 自动转整数、bool 自动识别开关。

import typer  def main(age: int):     print(f"明年你就 {age + 1} 岁了")  if __name__ == "__main__":     typer.run(main)

import typer  def main(     name: str = typer.Option(..., "--name", "-n", help="你的名字"),     count: int = typer.Option(1, "--count", "-c", help="重复次数"),     verbose: bool = typer.Option(False, "--verbose", "-v", help="是否啰嗦"), ):     for _ in range(count):         msg = f"Hello {name}"         if verbose:             msg += " (verbose mode)"         print(msg)  if __name__ == "__main__":     typer.run(main)

import typer  app = typer.Typer()  @app.command() def init():     """初始化项目"""     print("已初始化项目")  @app.command() def commit(message: str = typer.Option(..., "--message", "-m")):     """提交改动"""     print(f"已提交：{message}")  if __name__ == "__main__":     app()

import typer  def main(     username: str = typer.Option(..., prompt="你的用户名"),     password: str = typer.Option(         ..., prompt=True, hide_input=True,         help="登录密码（输入时不显示）",     ), ):     print(f"欢迎, {username}!（密码长度 {len(password)}）")  if __name__ == "__main__":     typer.run(main)

import typer  def main():     typer.secho("成功！", fg=typer.colors.GREEN, bold=True)     typer.secho("警告～", fg=typer.colors.YELLOW)     typer.secho("出错了", fg=typer.colors.RED, bg=typer.colors.WHITE)  if __name__ == "__main__":     typer.run(main)

import typer from pathlib import Path  app = typer.Typer()  @app.command() def rename(     folder: Path = typer.Argument(..., help="目标目录"),     prefix: str = typer.Option("", "--prefix", "-p", help="加的前缀"), ):     """批量给 .txt 文件加前缀"""     files = list(folder.glob("*.txt"))     if not files:         typer.secho("没找到 .txt 文件", fg=typer.colors.YELLOW)         raise typer.Exit(code=1)      with typer.progressbar(files, label="重命名中") as bar:         for f in bar:             f.rename(f.with_name(f"{prefix}{f.name}"))      typer.secho(f"完成！处理了 {len(files)} 个文件", fg=typer.colors.GREEN)  if __name__ == "__main__":     app()

import typer  app = typer.Typer()  @app.callback() def main(verbose: bool = typer.Option(False, "--verbose")):     """我的超级工具集"""     if verbose:         print("详细模式已开启")  @app.command() def run():     print("运行中...")  if __name__ == "__main__":     app()

1. 忘记 if __name__ == "__main__": app()：只定义了命令却没调用 app()，跑脚本啥也不发生。

2. 参数没写类型注解：Typer 靠注解推断参数类型，漏了 : str 这类标注，它不知道怎么解析，直接报错。

3. 把"可选参数"写成了 Argument：想做成 --xxx 就该用 Option，否则会被当成必填位置参数。

4. 子命令忘了 @app.command()：函数定义好了却没装饰，Typer 根本不会注册它。

5. 布尔参数自己解析字符串：别写 flag: str 再判断 "true"，直接用 bool，Typer 自动支持 --flag / --no-flag。