如何让Python Typer全局--verbose选项支持命令行任意位置输入？

问题场景 #

现有基于Python Typer框架编写的程序，目前仅./myapp --verbose books list这种调用方式能触发verbose模式，希望全局选项--verbose可在命令行任意位置生效，以下三种调用效果完全一致：

$ ./myapp --verbose books list
$ ./myapp books --verbose list
$ ./myapp books list --verbose

不想为每个命令/子命令单独添加--verbose选项，寻求高效实现方案。

解决方案 #

利用Typer的上下文传递状态，配合复用选项定义和批量配置子Typer的方式，无需重复编写代码即可实现需求。修改后的完整代码如下：

#!/usr/bin/env python
import typer
from typing_extensions import Annotated

# 统一复用verbose选项配置，避免重复编写
VERBOSE_OPTION = Annotated[
    bool,
    typer.Option(
        "--verbose", "-v",
        help="运行在verbose模式",
        is_eager=True  # 关键设置：让选项优先被解析，无论位置
    )
]

app = typer.Typer()

# 封装子Typer创建逻辑，自动添加verbose处理回调
def create_sub_app() -> typer.Typer:
    sub_app = typer.Typer()
    
    @sub_app.callback(invoke_without_command=True)
    def sub_callback(ctx: typer.Context, verbose: VERBOSE_OPTION = False):
        # 更新上下文的verbose状态
        if verbose:
            ctx.state.verbose = True
        # 若父上下文已有状态则继承
        if not hasattr(ctx.state, "verbose"):
            ctx.state.verbose = False
        return
    
    return sub_app

# 创建带verbose处理的子应用
books_app = create_sub_app()
app.add_typer(books_app, name="books")

authors_app = create_sub_app()
app.add_typer(authors_app, name="authors")

### 子命令实现
@books_app.command("list")
def books_list(ctx: typer.Context) -> None:
    if ctx.state.get("verbose", False):
        print("进入 'books_list'")

@books_app.command("delete")
def books_delete(
    ctx: typer.Context,
    book_name: Annotated[str, typer.Argument(help="要删除的书名")],
) -> None:
    if ctx.state.get("verbose", False):
        print("进入 'books_delete'")

### 主命令回调
@app.callback(no_args_is_help=True, invoke_without_command=True)
def main(ctx: typer.Context, verbose: VERBOSE_OPTION = False) -> None:
    # 初始化上下文的verbose状态
    ctx.state.verbose = verbose

if __name__ == "__main__":
    app()

方案说明 #

• 统一选项定义：把--verbose的配置做成复用变量，避免在多个位置重复编写相同的选项参数。
• 上下文传递状态：用ctx.state替代全局变量存储verbose开关状态，所有子命令都能直接访问最新状态，避免全局变量的潜在问题。
• 批量配置子Typer：通过封装函数批量创建子Typer实例，自动添加处理verbose的回调，无需逐个手动配置。
• 优先解析选项：设置is_eager=True让Typer优先解析该选项，无论它出现在命令行的哪个位置，确保子命令执行时能读取到正确的状态。

内容的提问来源于stack exchange，提问作者rlandster