Python Click如何设置可被子命令继承、运行时覆盖的全局选项

Click装饰器中声明的选项默认值会在模块导入阶段完成求值固化，父命令的参数解析发生在模块导入之后的运行阶段，因此你在装饰器里通过f字符串拼接的默认路径，永远只能读取到Config类的初始值，哪怕后续在父命令里修改Config属性，也赶不上子命令选项初始化的时机，自然不会生效。

遵循Click的上下文传递设计，将子命令依赖全局参数的默认值从「装饰器加载时固定」改为「命令执行时动态生成」，实现步骤如下：

1. 修正入口文件的上下文传递逻辑，统一处理路径格式

# 入口文件 cli.py
import click
from config import Config
from command import some_command

@click.group()
@click.option('--base-path', show_default=True, default=Config.base_path, help="全局项目根路径")
@click.pass_context
def cli(ctx, base_path):
    """CLI入口"""
    ctx.ensure_object(dict)
    # 统一去除路径末尾斜杠，避免拼接出现双斜杠问题
    ctx.obj['base_path'] = base_path.rstrip('/')

cli.add_command(some_command)

if __name__ == '__main__':
    cli()

2. 修改子命令逻辑，不在装饰器中硬编码默认路径，运行时动态判断生成

# command.py
import click
import os

@click.command()
# 默认值设为None，不在装饰器阶段做路径拼接
@click.option('--path', default=None, help="目标JSON文件路径，默认基于全局base_path生成")
@click.pass_context
def some_command(ctx, path):
    """命令示例"""
    # 用户未显式传入path时，从上下文读取全局base_path动态生成默认路径
    if path is None:
        path = os.path.join(ctx.obj['base_path'], 'some', 'another_path.json')
    # 自动展开~开头的家目录路径
    path = os.path.expanduser(path)
    print(f"my path is: {path}")

该实现的优先级逻辑完全符合预期：

• 执行cli some_command：默认读取配置文件初始base_path，输出my path is: /home/project/some/another_path.json
• 执行cli --base-path ~/custom/path some_command：动态基于传入的根路径拼接，输出对应家目录下的自定义路径
• 执行cli --base-path ~/custom/path some_command --path /tmp/test.json：用户显式传入的path优先级最高，输出my path is: /tmp/test.json

不要尝试通过调整模块导入顺序、猴子补丁修改Config类属性的方式解决问题，这类方案会引入隐式依赖，后续加新子命令时很容易出现时序bug，维护成本极高。

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