首页/开发/CI/CD 与发布速查/.env 文件的使用边界
环境与配置管理60 条

.env 文件的使用边界

.env 适合本地开发便利:不放版本库、不同步生产;提交模板(.env.example),生产环境由平台注入。

CI/CD 与发布速查开发更新于 2026-10-12
本地.env + 加载库,快速启动开发
仓库.env.example 列键不含值;.env 进 .gitignore
生产由平台注入(环境变量/挂载/密钥管理),不落地明文文件

.gitignore

.gitignore
.env
.env.local
.env.*.local
!.env.example
「只差一行没提交」的历史事故多是 .env:加忽略规则 + 扫描双保险。

易错点

  • .env 被提交后继续使用原值:删除不等于安全,立即轮换其中凭据
  • 生产读 .env:配置来源与变更审计缺失,统一平台注入

数据来源与参考

  • 12factor.net《Config》
  • dotenv 项目文档(motdotla/dotenv)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌