推荐用字典继承+环境变量驱动加载:config/下分base.py、development.py、production.py,主类通过dict.update合并;YAML用&anchor/*anchor复用字段,Python侧deep merge;敏感配置走环境变量或加密文件。

怎么用 Python 字典做配置模块化,又不变成硬编码
直接把配置写死在 config.py 里看似简单,但一到换环境(dev/test/prod)就容易改错、漏改、提交敏感信息。核心思路是:把配置按层级拆开,用字典继承 + 环境变量驱动加载,而不是靠手工 if ENV == 'prod': ... 堆逻辑。
推荐结构:
-
config/目录下放base.py(通用项,如日志格式、基础路径) -
development.py、production.py各自只覆盖差异字段,比如DEBUG = True或REDIS_URL - 主配置类用
dict.update()合并,不是简单 import 多个模块再手动赋值
示例关键片段:
class Config:
SECRET_KEY = os.getenv('SECRET_KEY', 'dev-key')
# 其他基础配置...
<p>class ProductionConfig(Config):
DEBUG = False
DATABASE_URL = os.getenv('DATABASE_URL')</p><h1>加载逻辑(在 app 初始化时)</h1><p>env = os.getenv('FLASK_ENV', 'development')
config_map = {'development': DevelopmentConfig, 'production': ProductionConfig}
app.config.from_object(config_map[env])注意:这里 from_object 是 Flask 的惯用法,非 Flask 项目可仿照实现字典合并逻辑,别直接 globals().update(...) —— 容易污染命名空间。
YAML 文件怎么分环境加载又不重复写 key
YAML 比 Python 字典更适合非开发者修改(比如运维填数据库地址),但原生不支持“继承”或“引用”。别用 !include 这种非标准扩展,它会让解析器报错或行为不一致。
正确做法是:用标准 YAML 的 &anchor 和 *anchor 实现字段复用,再配合 Python 侧做环境合并:
立即学习“Python免费学习笔记(深入)”;
- 写一个
common.yaml,用&default_db定义共用的 DB 配置块 - 在
production.yaml中用*default_db引入,并只覆盖host和port - Python 侧用
PyYAML加载后,用dict_deep_update()(自己写或用deepmerge包)合并 base + env 配置,不是简单dict.update()
常见错误:yaml.load() 不带 Loader 参数 → 可能执行任意代码;os.path.join('config', env + '.yaml') 没校验文件存在 → 启动直接崩溃。务必加 try/catch 和缺失提示。
为什么不能把所有配置塞进一个 YAML 文件用 if 切换
看起来省事,比如在 YAML 里写:
database:
development:
url: sqlite:///dev.db
production:
url: postgresql://...但这样会导致:启动时必须完整解析整个文件,哪怕只用 development 部分;无法被 IDE 自动补全字段;CI/CD 脚本难做差异化注入(比如只替换 production.database.url)。
更严重的是,这种结构让“配置即代码”的优势消失——你没法对 production.yaml 单独做 schema 校验、diff 审计或加密处理。实际项目中,应坚持“一个环境一个文件”,靠加载逻辑决定用哪个,而不是靠 YAML 内部分支。
敏感配置(密码、密钥)该怎么安全落盘
绝对不要把 SECRET_KEY、API_TOKEN 明文写在 YAML 或 Python 文件里提交到 Git。可行路径只有两条:
- 环境变量优先:代码里统一用
os.getenv('DB_PASSWORD'),部署时由容器或 systemd 注入 - 独立加密文件:用
cryptography库解密本地secrets.encrypted,但必须确保私钥不进 Git,且解密失败时明确报错(别静默 fallback 到默认空值)
额外提醒:YAML 的 !!str 或 !!int 类型标记在跨语言解析时不稳定,尤其和 Go/JS 服务联调时容易出类型错。除非必要,全部用字符串,靠代码侧转类型(int(os.getenv('PORT', '5000')))。
模块化配置最难的不是语法,而是让团队所有人遵守同一套加载顺序和覆盖规则。一旦出现“这个配置在 A 文件里定义、B 文件里覆盖、C 脚本里又重置”,就再也理不清了。


















