对齐环境配置，不暴露真实值
.env 文件对比与校验工具 — 查找缺失、重复和空变量
在浏览器本地对比和校验 .env 文件，找出缺失、多余、为空、重复或值已变化的环境变量；默认隐藏真实值，并可生成安全的 .env.example。
环境变量键名对照表
| 变量名 | 开发环境 | 预发布环境 | 生产环境 | 建议操作 |
|---|---|---|---|---|
| API_URL | 已配置 | 已配置 | 已配置 | 值不同 |
| LOG_LEVEL | 已配置 | 缺失 | 已配置 | 补到预发布环境 |
| DEBUG | 已配置 | 已配置 | 多余 | 检查生产环境 |
| DATABASE_URL | 值为空 | 已配置 | 已配置 | 补全开发环境 |
解析差异
不同 dotenv 加载器并不共享一份完全一致的规范。
NAME=value # note行尾注释的解析规则不同
export NAME=value只有部分加载器接受 export
MULTILINE="one
two"引号内换行的语义不同
NAME=value
NAME=again重复变量的覆盖顺序必须明确
最终生效的值取决于加载顺序
- 1进程环境变量
- 2当前模式专用文件
- 3本地覆盖文件
- 4基础 .env 文件
- 5应用默认值
具体优先级会随框架和部署平台变化。可以先选择对应方言检查语法，但最终仍要以实际运行时的加载规则为准。
可分享的报告应该展示状态，而不是泄漏密钥
DATABASE_URL=postgres://name:password@host/dbDATABASE_URL · 已配置 · 值已变化 · 内容已隐藏变量名看起来像 secret 只能作为审查提示，不能证明它的值一定敏感，也不能证明凭据已经泄漏。
生成 .env.example 后，逐项检查占位值
1 · 解析
尽可能保留注释和变量顺序。
2 · 隐藏真实值
用占位值替换内容，不复制凭据。
3 · 补充说明
写清必填格式和确实安全的默认值。
4 · 人工复核
移除私有主机名、账号标识和运维线索。
部署前检查清单
- 所有必需变量都存在
- 必需变量的值不为空
- 重复变量已经处理
- 只在特定环境存在的变量符合预期
- 已记录运行时的加载优先级
.env 文件常见问题
- 两份 .env 的变量名完全一致，就代表环境配置相同吗？
- 不代表。这只能说明键名齐全；变量值、基础设施访问权限、加载顺序和应用默认值仍可能不同。
- .env.example 应该保留真实值吗？
- 应该使用经过审查的占位值和明确安全的默认值。不要假设自动隐藏功能能识别每一项凭据、私有主机名或账号标识。
- 为什么要检查重复的环境变量？
- 不同加载器可能采用第一次或最后一次定义。重复变量会掩盖真正生效的值，让开发者误判当前配置。