技能介绍

那些藏在 .env 里的“隐形炸弹”

项目本地调试突然连不上数据库， CI 流水线拿错密钥，十有八九是 .env 文件出了问题。重复的键名会让后面的值悄悄覆盖前面的，格式不规范则可能导致解析工具直接报错，而人工排查时，这些错误往往藏在几十行配置里难以察觉。

让机器帮你找错

这个技能借助 dotenv-linter 来定位这些隐患。它支持检查 .env 文件、.env.example 等常见配置文件，核心能力包括：

重复键检测：找出同名键被多次定义的情况，避免值被意外覆盖；
格式错误识别：检测值的引号使用不当、缺少等号分隔符等不符合规范的写法；
不安全格式化提示：标记可能泄露敏感信息的格式，比如未用引号包裹的含空格值。使用时只需指定待检查的文件，工具会输出具体的问题位置和修改建议，开发者根据提示调整即可。

别把 linter 当“万能药”

需要注意的是，dotenv-linter 只做语法和格式层面的检查，不会验证键值的业务逻辑是否正确。例如，它能发现 API_KEY 重复定义，但不会告诉你这个密钥是否有效。此外，工具基于 .env 的简单键值格式（如 FOO=BAR），如果项目中用了自定义的复杂解析逻辑，可能需要结合其他工具一起使用。