# 环境变量检查器

在 .env 文件导致部署故障前，先检查其中的错误。检查器会查找重复键、缺少等号的行、未闭合的引号、等号两侧的空格、未加引号且包含空格的值、空值，以及文件中未定义的变量引用。每项检查结果都会列出行号和键名。

## 常见问题

### 哪些情况会报告为错误？

文件无法正确读取的行：缺少等号的行、包含无效字符的键、未闭合的引号，以及闭合引号后出现非注释文本的行。

### 哪些情况会报告为警告？

能够加载但经常引发问题的行：重复定义的键、等号两侧有空格、未加引号且包含空格的值、未加引号的值中出现多余引号、不是有效 shell 名称的键，以及引用了文件中未定义的变量。

### 提示是什么？

值得留意但通常是有意为之的情况：空值，以及包含小写字母的键，因为环境变量通常使用大写字母。

### 为什么等号两侧的空格会造成问题？

dotenv 可以容忍这些空格，但执行 source 加载文件的 shell 会将 KEY = value 读作命令；Docker 的 --env-file 也会拒绝名称后带空格的写法。使用 KEY=value 则适用于所有场景。

### 如何检查变量引用？

系统会将未加引号和双引号值中的 $NAME 或 ${NAME} 等引用与文件中的键进行比较。如果文件未定义某个被引用的键，检查器会报告该引用，因为只有环境中提供了对应值时，它才会被填入。

### 我的文件会被发送到其他地方吗？

不会。文件仅由此工具检查，不会被存储。不过，将生产环境文件粘贴到任何地方前，请考虑用占位符替换真实密钥。

在这里投放广告？

[给我们发邮件](mailto:hi@dennn.is?subject=%E5%9C%A8%20OneClick%20Pro%20%E4%B8%8A%E6%8A%95%E6%94%BE%E5%B9%BF%E5%91%8A)

[广告 通过一个 MCP 服务器为你的 AI 代理提供 433 种工具。](https://multitaskai.com/zh/?ref=oneclickpro)
