Python3.12迁移：setuptools替代distutils.strtobool的方案及参数解析优化

1. setuptools中的替代方案 #

setuptools提供了和distutils.util.strtobool完全兼容的替代实现，位于setuptools.utils模块下。你只需替换导入语句，原有代码逻辑可以直接复用：

from setuptools.utils import strtobool
arg_parser = argparse.ArgumentParser()
arg_parser.add_argument("-r", "--rebuild_all", type=lambda x: bool(strtobool(x)), default=True)

这个实现的行为和原distutils版本一致，支持解析y/yes/t/true/on/1为True，n/no/f/false/off/0为False，且大小写不敏感。

2. 更安全的字符串转布尔值方法 #

如果需要更严格的解析逻辑（避免意外解析模糊输入），推荐以下几种方案：

自定义严格解析函数 #

自己实现一个限定输入范围的解析函数，无效输入直接抛出错误，让argparse提前拦截非法参数：

def str_to_bool(s):
    normalized = s.strip().lower()
    if normalized in ("true", "yes", "1"):
        return True
    elif normalized in ("false", "no", "0"):
        return False
    else:
        raise ValueError(f"Invalid boolean string: '{s}'")

# 在argparse中使用
arg_parser = argparse.ArgumentParser()
arg_parser.add_argument("-r", "--rebuild_all", type=str_to_bool, default=True)

这种方式只接受明确的布尔相关输入，其他值会直接触发参数错误，比默认的strtobool更安全，适合命令行参数这种需要明确输入的场景。

使用argparse原生开关（纯布尔场景） #

如果你的--rebuild_all是纯开关参数（用户只需指定是否启用，无需传入字符串值），可以直接用argparse的action参数，完全跳过字符串解析：

arg_parser = argparse.ArgumentParser()
# 不加参数时为False，加上--rebuild_all时为True
arg_parser.add_argument("-r", "--rebuild_all", action="store_true", default=False)

注意这种方式的默认值逻辑和你原有代码相反，需根据实际需求调整。

复刻原strtobool实现（完全无依赖） #

如果不想依赖setuptools，也可以直接把原distutils.util.strtobool的代码复制到项目中，彻底脱离外部依赖：

def strtobool(val):
    val = val.lower()
    if val in ("y", "yes", "t", "true", "on", "1"):
        return 1
    elif val in ("n", "no", "f", "false", "off", "0"):
        return 0
    else:
        raise ValueError(f"Invalid truth value: {val!r}")

# 使用方式和原来一致
arg_parser.add_argument("-r", "--rebuild_all", type=lambda x: bool(strtobool(x)), default=True)

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