Python如何加载运行时传入的YAML配置并让所有子模块可访问

核心利用Python模块全局单例的特性，仅需修改settings.py和入口文件main.py，无需改动任何其他业务模块的导入逻辑，实现成本极低。

1. 修改settings.py模块 #

新增配置加载方法，将YAML文件的内容动态写入模块属性：

# settings.py 原有默认配置保留
DEBUG = False
PORT = 8000
DATABASE = {
    "host": "127.0.0.1",
    "port": 3306
}

def load_config(yaml_path: str):
    import sys
    import yaml
    # 获取当前模块对象
    current_module = sys.modules[__name__]
    # 读取YAML配置
    with open(yaml_path, "r", encoding="utf-8") as f:
        yaml_cfg = yaml.safe_load(f)
    # 用YAML配置覆盖模块原有默认属性
    for k, v in yaml_cfg.items():
        # 可选：加校验只更新已存在的大写配置项，避免拼写错误注入无效配置
        if k.isupper() and hasattr(current_module, k):
            setattr(current_module, k, v)

2. 修改入口文件main.py #

拿到传入的YAML路径后，先加载配置再导入其他业务模块：

# main.py
import sys

if __name__ == "__main__":
    # 从命令行参数读取YAML配置路径
    if len(sys.argv) < 2:
        print("用法：python main.py <配置文件路径.yml>")
        sys.exit(1)
    config_path = sys.argv[1]
    
    # 第一步先加载配置
    import settings
    settings.load_config(config_path)
    
    # 加载完成后再导入所有业务模块
    from your_app import run
    run()

3. 业务模块无需任何修改 #

原有代码中所有import settings后读取配置的逻辑完全不变，所有模块读取到的都是YAML文件加载后的配置值。

注意事项 #

如果存在业务模块在模块级别（即函数外）直接初始化使用了settings的配置值，必须保证settings.load_config()的调用早于该业务模块的导入，否则该模块会读取到默认值而非YAML中的配置。如果无法调整导入顺序，可以把模块级别的初始化逻辑移入函数内部延迟执行。

方案优势 #

• 无侵入性：无需修改任何业务模块的代码，仅改动两个文件
• 没有额外依赖问题：不会出现循环导入、环境变量污染、文件复制等冗余逻辑
• 兼容性好：原有默认配置保留，YAML仅需填写需要覆盖的配置项即可

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