如何在Typer装饰的Python函数中正确调用带默认值的函数

你遇到的核心问题是：typer.Argument是Typer用于CLI参数解析的元数据对象，并非实际的参数值。当你直接将它作为函数默认参数时，Python会把ArgumentInfo实例原封不动传入函数，而不是自动提取其中的default字段值，导致后续字符串相关方法调用失效。

方案1：提取ArgumentInfo的默认值 #

在函数内部判断参数类型，手动提取默认值，兼容直接调用和CLI触发两种场景：

import typer

app = typer.Typer()

log_level_arg = typer.Argument(default="debug", help="The output logging level. This can be one of: debug, info, warning, error, and critical.")

@app.command()
def view(log_level: str = log_level_arg):
    """
    View IP address of switch in environment if it exists
    """
    # 处理直接调用时的ArgumentInfo对象
    if isinstance(log_level, typer.models.ArgumentInfo):
        log_level = log_level.get_default()
    print("log level:")
    print(log_level)
    print(type(log_level))

print("view:")
view()

方案2：Typer推荐的参数定义方式（分离默认值与CLI元数据） #

Typer支持在@app.command()装饰器中通过args参数声明CLI元数据，函数本身保留普通字符串默认值，完美兼顾两种调用场景：

import typer

app = typer.Typer()

@app.command(args=[
    typer.Argument("debug", help="The output logging level. This can be one of: debug, info, warning, error, and critical.")
])
def view(log_level: str = "debug"):
    """
    View IP address of switch in environment if it exists
    """
    print("log level:")
    print(log_level)
    print(type(log_level))

print("view:")
view()  # 直接调用得到字符串"debug"

方案3：复用参数定义的包装器（适合多命令共享参数） #

如果需要在多个命令中复用同一参数定义，可以写一个简单包装器，同时暴露默认值和Typer的Argument对象：

import typer

app = typer.Typer()

def shared_log_level_arg(default="debug"):
    arg = typer.Argument(default=default, help="The output logging level. This can be one of: debug, info, warning, error, and critical.")
    return {"arg": arg, "default": default}

log_level_config = shared_log_level_arg()

@app.command(args=[log_level_config["arg"]])
def view(log_level: str = log_level_config["default"]):
    print("log level:")
    print(log_level)
    print(type(log_level))

@app.command(args=[log_level_config["arg"]])
def edit(log_level: str = log_level_config["default"]):
    print("edit log level:")
    print(log_level.lower())  # 正常调用字符串方法

print("view:")
view()

以方案2为例，运行python main.py view会输出：

view:
log level:
debug
<class 'str'>

log level:
debug
<class 'str'>

直接调用和CLI触发都能得到正确的字符串类型默认值，解决了类型不匹配的问题。

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