Python Click库如何仅在使用--help参数时展示自定义附加消息

错误原因 #

你手动自定义--help参数的操作覆盖了Click框架内置的--help默认处理逻辑：默认的--help参数被调用时会自动输出帮助信息并终止程序运行，而你添加的自定义--help选项没有绑定对应的处理逻辑，参数解析完成后程序会继续执行，检测到缺少必填的子命令后就抛出了Missing command报错。

正确实现方式 #

首先删掉你自己添加的@click.option("--help")相关代码，不需要重复定义--help参数，以下是两种符合需求的实现方案：

方案1：固定自定义内容（最简便） #

直接使用Click组命令内置的epilog参数，该参数的内容会自动追加到帮助信息的末尾，仅在调用--help时展示：

# 找到manim/__main__.py中主命令的定义，添加epilog参数即可
@click.group(
    context_settings={"help_option_names": ["-h", "--help"]},
    # 此处填入你需要追加的自定义消息
    epilog="你要添加的自定义消息内容，支持多行文本"
)

方案2：动态生成自定义内容 #

如果你的自定义消息需要动态生成（比如读取版本、配置信息后拼接），可以继承click.Group类重写帮助格式化方法：

import click

# 自定义Group类
class CustomHelpGroup(click.Group):
    def format_help(self, ctx, formatter):
        # 先输出原生的完整帮助内容
        super().format_help(ctx, formatter)
        # 追加自定义内容，支持动态拼接逻辑
        custom_msg = "\n你想要添加的动态自定义消息\n"
        formatter.write(custom_msg)

# 给主命令指定自定义的Group类
@click.group(cls=CustomHelpGroup)
def main():
    pass

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