Python3.8+兼容argparse合并布尔开关参数帮助信息方法

直接自定义兼容Python 3.8的布尔可选参数动作类，复用Python 3.9+官方BooleanOptionalAction的逻辑，不需要手动创建互斥组，即可实现参数行为、帮助展示完全符合要求，同时兼容3.8到最新版本的Python。

完整可运行代码 #

import argparse
from typing import Optional, Sequence

# 版本兼容处理：3.8无内置BooleanOptionalAction时自定义实现
if not hasattr(argparse, "BooleanOptionalAction"):
    class BooleanOptionalAction(argparse.Action):
        def __init__(
            self,
            option_strings: Sequence[str],
            dest: str,
            default: Optional[bool] = None,
            type: None = None,
            choices: None = None,
            required: bool = False,
            help: Optional[str] = None,
            metavar: None = None,
        ) -> None:
            # 自动生成对应的--no-xxx否定选项
            extended_opts = []
            for opt in option_strings:
                extended_opts.append(opt)
                if opt.startswith("--"):
                    extended_opts.append(f"--no-{opt[2:]}")
            
            super().__init__(
                option_strings=extended_opts,
                dest=dest,
                nargs=0,
                default=default,
                type=type,
                choices=choices,
                required=required,
                help=help,
                metavar=metavar,
            )

        def __call__(self, parser, namespace, values, option_string=None):
            # 根据传入选项设置布尔值，--no-开头的选项设为False
            setattr(namespace, self.dest, not option_string.startswith("--no-"))

        def format_usage(self):
            # 让usage行里两个选项用|分隔显示
            return " | ".join(self.option_strings)


# 参数定义部分，和Python3.9+原生写法完全一致
if __name__ == "__main__":
    parser = argparse.ArgumentParser(description="test parser")
    parser.add_argument(
        "--feature",
        action=BooleanOptionalAction,
        default=True,
        help="help 1 & 2"
    )
    args = parser.parse_args()
    print(args.feature)

效果说明 #

• 运行逻辑和原有手动互斥组实现完全一致：传入--feature时参数值为True，传入--no-feature时为False，默认值保持True
• 帮助输出完全匹配预期格式：

  usage: test.py [-h] [--feature | --no-feature]
  
  optional arguments:
    -h, --help            show this help message and exit
    --feature, --no-feature
                          help 1 & 2
  

• 版本兼容性：Python 3.9及以上版本会自动使用官方内置的BooleanOptionalAction实现，3.8版本使用自定义类，无额外依赖、无版本兼容问题。

原有写法的问题 #

手动给互斥组添加store_true和store_false两个独立参数时，argparse会将两个参数识别为独立的参数条目，默认会分两行渲染帮助，没有原生配置支持合并展示；而绑定到同一个Action实例的多个选项串，argparse会自动合并到同一行展示。

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