本文目录
什么是 .env 文件？
.env 文件以键值对的形式存储环境变量，用于应用程序配置。遵循 dotenv 标准，每一行包含一个变量名、一个等号和一个值。这类文件能将 API 密钥和数据库连接地址等敏感数据隔离在源代码之外。
尽管语法简单，.env 文件却很容易出现一些不易察觉的错误——重复的键、缺失的值、错误的引号使用或行尾多余的空白字符。.env 校验器能在这些问题引发应用运行时故障之前就将它们捕获。
.env 校验的工作原理
.env 校验器会逐行解析文件，检查语法规则，并检测那些可能在生产环境中导致配置错误的常见问题。
- 语法解析——校验 KEY=VALUE 格式、带引号的值、多行支持以及注释处理
- 重复检测——标记出现不止一次的键，这类键可能因最终加载哪个值的不同而导致不可预测的行为
- 空值警告——识别未赋值的键，它们可能在运行时引发未定义变量错误
免费试用 —— 无需注册
校验你的 .env 文件 →何时校验 .env 文件
环境文件校验能够防止与配置相关的服务中断，并简化团队协作。
- CI/CD 流水线——在部署前校验 .env 文件，尽早发现缺失或格式错误的变量
- 团队新人入职——新开发者可以借助 .env.example 作为参照，核对本地 .env 是否符合预期格式
- 部署校验——对比预发布环境与生产环境的 .env 文件，确保所有必需变量均已就位
常见问题
.env 文件的标准格式是什么？
dotenv 格式采用 KEY=VALUE 键值对，每行一个。值可以不加引号、使用单引号或双引号。以井号开头的行为注释。空行会被忽略。虽然没有官方 RFC 规范，但 Node.js 的 dotenv 和 python-dotenv 等库已确立了事实上的标准。
我应该把 .env 文件提交到版本控制吗？
不应该。.env 文件通常包含 API 密钥和数据库密码等机密。请将 .env 加入你的 .gitignore，并提供一个带占位值的 .env.example 文件，让团队成员既能知道需要哪些变量，又不会暴露真实的机密。
如何为不同环境处理不同的 .env 文件？
使用针对特定环境的文件，例如 .env.development、.env.staging 和 .env.production。大多数框架会根据 NODE_ENV 或 APP_ENV 变量自动加载这些文件。请对每个文件独立进行校验，以确保该环境所需的全部变量都已存在。