无需修改python-click源码，如何自定义col_max值？

方案一：继承自定义HelpFormatter #

通过继承Click的HelpFormatter类，重写write_dl方法并修改col_max的默认值，然后在目标命令中指定使用这个自定义格式化器。

import click

class CustomHelpFormatter(click.HelpFormatter):
    def write_dl(self, rows, col_max=16, col_spacing=2):
        super().write_dl(rows, col_max=col_max, col_spacing=col_spacing)

@click.command(formatter_class=CustomHelpFormatter)
@click.option("--very-long-option-name", help="这是一个长选项的帮助文本")
@click.option("--another-long-option", help="另一个长选项的帮助说明")
def cli(very_long_option_name, another_long_option):
    pass

if __name__ == "__main__":
    cli()

这种方式是面向对象的标准扩展方式，只会影响指定了formatter_class的命令，不会全局修改Click的行为，适合局部调整的场景。

方案二：猴子补丁全局修改 #

如果需要让所有Click命令都使用修改后的col_max，可以直接对HelpFormatter.write_dl方法打补丁，替换其默认参数。

import click
from click.formatting import HelpFormatter

# 保存原始方法
original_write_dl = HelpFormatter.write_dl

# 定义补丁方法，修改col_max默认值为16
def patched_write_dl(self, rows, col_max=16, col_spacing=2):
    return original_write_dl(self, rows, col_max=col_max, col_spacing=col_spacing)

# 替换原方法
HelpFormatter.write_dl = patched_write_dl

@click.command()
@click.option("--very-long-option-name", help="这是一个长选项的帮助文本")
@click.option("--another-long-option", help="另一个长选项的帮助说明")
def cli(very_long_option_name, another_long_option):
    pass

if __name__ == "__main__":
    cli()

这个方案会全局生效，所有使用默认HelpFormatter的命令都会自动应用新的首列宽度，适合需要统一调整的场景，但要注意避免和其他修改该方法的代码产生冲突。

注意事项 #

• 以上方案仅针对Click 8.1.3版本验证有效，后续版本如果write_dl方法的参数结构发生变化，需要相应调整代码。
• 猴子补丁属于侵入式修改，使用时需要确认不会影响项目中其他依赖Click的功能。

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