环境配置检查

.env 文件对比

把预期配置放在基准 A,把实际配置放在目标 B。核对示例文件时,可开启「仅比较键」。

.env 文件对比

基准 A

目标 B

在浏览器内运行,输入只留在内存,不进入网址、遥测或本地历史。

对比选项

遮罩用于结果和导出,原始输入仍然可见。仅比较键时不输出任何值。

请输入至少一份配置,允许另一侧为空。

本地运行正常、换个环境就报错时,.env 文件对比能先帮你排查变量是否漏配。它按键名对齐配置,文件里调换了几行、增加了注释,都不会掩盖真正缺失的那一个变量。

基准文件只代表你拿来核对的配置,不代表其中的密码或地址适合目标环境。发现缺失后仍需按应用要求填写;已经声明但值为空的变量,也可能无法满足应用启动条件。

为什么使用 .env 文件对比

示例文件与真实配置,各自承担不同角色

.env 文件对比提供真正的仅比较键模式:两侧都存在的变量,即使值不同也算匹配。用模板检查生产环境时,可以把注意力放在缺失键上;排查端口或接口地址变化时,再恢复值比较。

两份配置按相同键标记对齐,分别突出新增、缺失和变化的条目。

报告隐藏所有值,不靠名字猜测密钥

安全对比模式使用固定遮罩,不保留值的前缀、后缀或长度。复制和下载沿用当前遮罩选项,普通命名的敏感变量也会被隐藏。原始输入编辑器仍然显示粘贴的内容。

差异报告中的值统一替换为固定遮罩,键标记和变化分组保持可见。

先确定你要核对什么

01

先辨认 A 到 B 的方向

用 .env.example 做基准 A,实际配置做目标 B。「B 缺失」表示目标没有模板中声明的变量;把两侧内容反过来,新增加和缺失的含义也会反过来。

02

区分忽略值与忽略键

仅比较键会跳过共有变量的值变化。忽略键则把指定变量完全排除在统计之外,必须填写完整名称。忽略 PORT 不会忽略 PORT_EXTRA,大小写也不会自动合并。

03

确认结果已经更新

输入或参数修改后,旧结果会变淡并禁用导出。自动模式停顿 350 ms 后更新;关闭自动模式时,可按 Ctrl/Cmd + Enter 对比。导出前留意重复赋值的行号提示。

区分变量缺失与配置变化

三组差异直接对应排查任务

.env 文件对比把结果分为 B 新增、B 缺失和值变更,相同变量只计数。分组内按键名稳定排序,便于逐项回到原文件核对,不必手动给原配置重新排序。

环境变量对比不受排版干扰

空行、注释和变量顺序不参与比较。TOKEN= 与 TOKEN="" 都表示已存在的空字符串;只有完全没有这个键,才属于缺失,避免把模板里的空值误判成漏配。

完整导出配置差异

复制与下载使用同一份当前结果。屏幕每次展示 100 项,报告仍包含全部变化和重复键诊断;仅比较键时不输出值,即使之前关闭过遮罩也不会带出旧值。

解析方式与使用边界

采用明确的赋值语法
键名由英文字母、数字、下划线组成,不能以数字开头;允许 export 前缀。第一个等号分隔键和值,后续等号属于值。未加引号时,# 后是注释;需要保留 # 时请给值加引号。
引号与换行有明确范围
单、双引号支持跨行,并保留引号内的首尾空白。双引号处理 \n、\r、\" 和 \\,其余转义保留原样;单引号保留反斜杠。不支持反引号包裹或未加引号的反斜杠续行。
重复定义与语法错误分开处理
同名键采用最后一次赋值,并报告重复行及被覆盖行。有非法键名、缺少等号或引号未闭合时,停止比较并阻止导出残缺结论。每侧最多 1 MiB、10,000 次赋值。
不推算运行时值,也不自动补密钥
${HOST}、$HOST 和命令替换都按字面文本比较,不执行 Shell、不读取进程环境、不判断凭据是否有效。工具不合并文件、不生成示例文件,也不会替你填入缺失的真实值。
输入与忽略名单的范围
本页接受两份粘贴文本,不提供文件上传、网址读取、第三个环境或仓库扫描。忽略项只支持完整键名,不支持通配符或正则表达式;被忽略的变量不参与差异和匹配计数。

.env 文件对比常见问题

注释和空白行是否参与比较?

空白行和以 # 开头的注释会跳过。未加引号的值遇到 # 时也会开始注释;引号内部的 # 会保留。把一条赋值改成注释后,该变量便不再由这条记录定义。

隐藏值的安全对比有什么作用?

隐藏结果值会把比较结果和导出报告中的每一个值替换成固定遮罩。它不会隐藏键名,也不会遮住原始输入框。仅比较键是另一种模式,会直接跳过值变化的判断。

Windows 换行格式是否受支持?

支持 Windows 的 CRLF 与常见 LF 换行,也接受文件开头的 BOM。比较前统一换行,不把换行格式差异计为配置变化。引号内的实际换行仍是值的一部分。

重复定义同一个变量会怎样?

采用最后一次出现的赋值,并提示该键的重复行号与上一处定义位置。即使两侧最终值相同,重复提示仍然保留,方便你排查配置被意外覆盖的问题。

比较两份 .env 的具体方法是什么?

把两份内容分别粘贴到 A、B,等待自动比较即可。需要核对变量是否齐全时开启仅比较键,需要排查值变化时关闭它。单侧为空可以检查全新增或全缺失,两侧都空则保持空状态。

对比结果或规则需要修正?

开始一次 .env 文件对比

先核对差异方向、忽略名单和重复键,再导出当前报告。