如何让Click CLI在帮助文本中显示lambda作为选项默认值的实际结果而非'dynamic'

你遇到的情况我太熟悉了——当用lambda作为Click选项的默认值时，show_default=True只会显示(dynamic)，而不是lambda实际返回的环境变量值，确实有点影响用户体验。

先还原下你的场景：
你的CLI代码是这样的：

@click.option(
    "--username",
    default=lambda: os.environ.get("USER", None),
    show_default=True,
    help="User name for SSH configuration.",
)

但执行--help后，帮助文本里默认值显示的是：

--username TEXT         User name for SSH configuration.  [default: (dynamic)]

下面给你两种实用的解决办法：

方法一：提前计算默认值（最直接高效） #

因为环境变量USER在CLI启动时就已经确定了，完全没必要用lambda来延迟获取。我们可以提前计算好默认值，直接传给default参数，这样show_default=True就会自动显示实际的默认值：

import os
import click

# 提前获取环境变量作为默认值
DEFAULT_USER = os.environ.get("USER", None)

@click.command()
@click.option(
    "--username",
    default=DEFAULT_USER,
    show_default=True,
    help="User name for SSH configuration.",
)
def cli(username):
    click.echo(f"Using username: {username}")

if __name__ == "__main__":
    cli()

这时候再执行--help，就会显示类似这样的内容（假设你的环境变量USER是john）：

--username TEXT         User name for SSH configuration.  [default: john]

方法二：自定义show_default的显示内容（适合必须用lambda的场景） #

如果你的默认值确实需要用lambda延迟计算（比如依赖某些运行时状态的复杂场景），可以提前计算一次默认值的结果，然后把这个结果作为字符串传给show_default参数，强制显示实际值：

import os
import click

# 计算一次默认值用于帮助文本显示
default_user = os.environ.get("USER", None)

@click.command()
@click.option(
    "--username",
    default=lambda: os.environ.get("USER", None),  # 保留lambda延迟计算逻辑
    show_default=str(default_user),  # 手动指定帮助中显示的默认值文本
    help="User name for SSH configuration.",
)
def cli(username):
    click.echo(f"Using username: {username}")

if __name__ == "__main__":
    cli()

这种方式下，帮助文本同样会显示实际的环境变量值，同时保留lambda的延迟计算逻辑。

补充说明 #

Click把可调用对象（比如lambda）作为default时，会判定这是动态默认值——也就是认为每次运行CLI时默认值可能不同，所以在帮助文本里统一显示(dynamic)，避免误导用户（比如如果默认值是当前时间，提前显示就不准确了）。但对于环境变量这种启动时就固定的值，提前计算完全没问题。

备注：内容来源于stack exchange，提问作者codeforester