如何在Python中实现建造者模式构建复杂配置对象-Python教程-PHP中文网

因为配置项多、有依赖、需校验且环境差异大，建造者模式可分离构造与表示，确保不可变性、复用模板、链式设置；set_*方法应即时校验，build()只返回纯数据类实例并补默认值，避免耗时操作和外部依赖。

如何在python中实现建造者模式构建复杂配置对象

为什么不用直接传参或字典初始化配置对象

因为配置项多、有依赖关系、部分字段需校验、不同环境（dev/staging/prod）模板差异大。硬编码 dict 或长参数列表会让调用方耦合校验逻辑，且新增字段时所有调用点都要改。建造者模式把「构造过程」和「表示」分离，让配置对象不可变、可复用模板、支持链式设置。

`Builder` 类必须封装校验和默认值逻辑

很多实现只做属性赋值，结果运行时才报错。正确做法是在 set_timeout、set_host 等方法里立刻检查合法性：

set_timeout(self, seconds: int) 应抛出 ValueError 当 seconds
set_host(self, host: str) 应拒绝空字符串或非法域名格式（可用 urllib.parse.urlparse 快速验证）
所有非必填字段应在 __init__ 中设为 None，并在 build() 中统一补默认值（如 timeout=30、retries=3）

避免在 `build()` 里做耗时操作

建造者不是工厂，不负责实例化外部资源。常见错误是把连接数据库、读取远程 YAML 配置的逻辑塞进 build() —— 这会让构建过程不可预测、难测试、无法缓存。正确边界是：

build() 只返回纯数据类（dataclass 或 NamedTuple）实例
如果需要从文件加载基础配置，应由外部传入 base_config: dict，建造者只做覆盖和增强
若需兼容旧版配置键名（如 "max_retry" → "retries"），转换逻辑放 __init__ 或单独的 from_legacy() 类方法，别混进 build()

用 `__post_init__` 替代手动校验更安全

如果用 @dataclass 定义最终配置类，把字段校验移到 __post_init__ 比在每个 set_* 方法里重复判断更可靠 —— 它能兜底所有构造路径（包括未来可能加的其他 builder 变体）。示例：

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

@dataclass(frozen=True)
class Config:
    host: str
    timeout: int
    retries: int = 3
<pre class="brush:python;toolbar:false;">def __post_init__(self):
    if not self.host or ":" in self.host:  # 简单域名检查
        raise ValueError("host must be non-empty and not contain ':'")
    if self.timeout = 1")

注意：此时建造者的 build() 方法只需传参给 Config(...)，校验交给 __post_init__ 自动触发。

复杂校验（如 timeout * retries ）仍建议放在 <code>build() 里显式检查，避免把业务约束埋进数据类。