环境变量检查器
在 .env 文件导致部署故障前,先检查其中的错误。检查器会查找重复键、缺少等号的行、未闭合的引号、等号两侧的空格、未加引号且包含空格的值、空值,以及文件中未定义的变量引用。每项检查结果都会列出行号和键名。
常见问题
哪些情况会报告为错误?
文件无法正确读取的行:缺少等号的行、包含无效字符的键、未闭合的引号,以及闭合引号后出现非注释文本的行。
哪些情况会报告为警告?
能够加载但经常引发问题的行:重复定义的键、等号两侧有空格、未加引号且包含空格的值、未加引号的值中出现多余引号、不是有效 shell 名称的键,以及引用了文件中未定义的变量。
提示是什么?
值得留意但通常是有意为之的情况:空值,以及包含小写字母的键,因为环境变量通常使用大写字母。
为什么等号两侧的空格会造成问题?
dotenv 可以容忍这些空格,但执行 source 加载文件的 shell 会将 KEY = value 读作命令;Docker 的 --env-file 也会拒绝名称后带空格的写法。使用 KEY=value 则适用于所有场景。
如何检查变量引用?
系统会将未加引号和双引号值中的 $NAME 或 ${NAME} 等引用与文件中的键进行比较。如果文件未定义某个被引用的键,检查器会报告该引用,因为只有环境中提供了对应值时,它才会被填入。
我的文件会被发送到其他地方吗?
不会。文件仅由此工具检查,不会被存储。不过,将生产环境文件粘贴到任何地方前,请考虑用占位符替换真实密钥。