首页/开发/CI/CD 与发布速查/12-Factor 的配置原则
环境与配置管理60 条

12-Factor 的配置原则

配置与代码严格分离:环境相关的一切(连接串、凭据、外部地址)都从环境注入,代码在任意环境按同一方式运行。

CI/CD 与发布速查开发更新于 2026-10-12
出处12-Factor App 第 III 条 Config、第 X 条 Dev/Prod Parity
反面模式把开发/生产差异写成代码里的常量或分支
判断标准代码可以开源而不泄露任何凭据——配置全在环境里

正反示例

正反示例
# 反例:代码里 if env == 'prod': db = '10.0.0.5'
# 正例:
export DATABASE_URL=postgres://user:pass@host:5432/app
「配置」指随部署环境变化的部分;不因环境变化的分级参数(如路由表)属于代码。

易错点

  • 把 .env 文件打进镜像:环境差异固化进制品,违背一次构建多处部署
  • 代码里散落环境判断分支:新环境接入要改代码,配置应集中注入

数据来源与参考

  • 12factor.net《Config》
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌