首页/开发/CI/CD 与发布速查/环境变量配置方式
环境与配置管理60 条

环境变量配置方式

以环境变量传递配置:语言无关、容器友好、平台原生支持;注意命名规范、类型转换与长度限制等边界。

CI/CD 与发布速查开发更新于 2026-10-12
优点与进程环境天然集成;十二要素实践;云平台与容器编排原生注入
局限全部是字符串(类型自行解析);命名空间扁平;排查时可能被日志带出
规范统一前缀(如 APP_)、明确类型约定、敏感项配合掩码

示例

示例
export APP_LOG_LEVEL=info
export APP_DB_POOL_SIZE=20
# 应用内:类型转换与默认值在代码统一处理
变量数量超过几十个后维护成本上升:多而复杂的配置更适合结构化配置文件 + 密钥分离。

易错点

  • 把复杂结构序列化进单个变量(大 JSON):可读性与校验性差,改用配置文件
  • 变量没有默认值也没有启动校验:部署到新环境要到首次请求才报错,改为在启动时校验

数据来源与参考

  • 12factor.net《Config》
  • Kubernetes 文档《Environment variables》
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌