能否复用Python的@click.option装饰器实现多命令共享公共选项？

当然可以！在Click中避免重复定义公共选项的最佳方式之一是将这些选项封装成自定义装饰器，这样每个命令只需要引用这个装饰器即可，不用反复写相同的@click.option语句。我自己写CLI工具时经常这么做，既能减少重复代码，还能方便统一修改公共选项的配置——比如哪天要改--foo的帮助文本，只需要在一处修改就行，不用两个命令都调整。

具体实现步骤 #

1. 先定义一个包含所有公共选项的装饰器：

import click
import functools

def common_options(func):
    # 在这里添加所有公共的click.option配置
    @click.option('--foo', is_flag=True, help='这是公共选项foo')
    @click.option('--bar', is_flag=True, help='这是公共选项bar')
    @functools.wraps(func)  # 必须保留原函数的元信息，否则Click可能无法正确识别命令
    def wrapper(*args, **kwargs):
        return func(*args, **kwargs)
    return wrapper

2. 修改你的原有命令，直接引用这个装饰器：

@click.command()
@common_options  # 先应用公共选项装饰器
@click.option('--unique-flag-1', is_flag=True, help='命令1独有的选项')
def command_one(foo, bar, unique_flag_1):
    # 直接使用所有参数，包括公共的foo、bar和独有的unique_flag_1
    if foo:
        print("触发了公共选项foo")
    if unique_flag_1:
        print("触发了命令1独有的选项")

@click.command()
@common_options
@click.option('--unique-flag-2', is_flag=True, help='命令2独有的选项')
def command_two(foo, bar, unique_flag_2):
    if bar:
        print("触发了公共选项bar")
    if unique_flag_2:
        print("触发了命令2独有的选项")

if __name__ == '__main__':
    # 可以单独调用命令，也用click.Group组织多个命令
    # 示例：用Group管理
    @click.group()
    def cli():
        pass
    cli.add_command(command_one)
    cli.add_command(command_two)
    cli()

关键注意点 #

• 一定要用functools.wraps(func)包装内层函数，这样能保留原命令函数的名称、文档字符串等元信息，否则Click在解析命令时可能会出现异常。
• 装饰器的应用顺序：公共选项装饰器要放在@click.command()之后、自定义选项之前，这样参数才能正确传递到命令函数中。

其他可选方案 #

如果你的CLI工具包含大量命令，也可以考虑使用click.Group结合类装饰器或者继承click.Command的方式来实现公共选项复用，但自定义装饰器是最轻量化、最容易理解的方案。

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