.env 文件怎么检查？环境变量、引号、换行和部署配置排查指南

环境变量看起来只是几行 KEY=value，但部署出错时，经常就是 .env 文件里的空格、引号、换行或变量名问题。

你可以用 .env 文件检查器 检查基础格式和可疑项。

常见格式

DATABASE_URL=postgres://user:pass@example.com/db
NEXT_PUBLIC_SITE_URL=https://example.com

等号左边是变量名，右边是值。变量名建议使用大写字母、数字和下划线。

常见错误

• 变量名前后有空格。
• 值里有多余引号。
• URL 里的 # 被当成注释。
• 私钥换行丢失。
• 本地和生产变量不一致。
• 前端变量缺少框架要求的前缀。

Next.js 里，只有特定前缀的变量会暴露给浏览器端。不要把密钥放进前端可见变量里。

私钥和多行内容

RSA 私钥、证书、JSON 配置经常包含换行。放进环境变量时，要确认平台支持多行，或使用 \n 转义。

部署后如果提示 key invalid，不一定是密钥错，也可能是换行被破坏。

本地、预览、生产要分开

同一个变量名在不同环境里可能值不同，例如数据库、回调地址、站点域名、API Key。不要把本地 .env 直接复制到生产。

建议维护一份变量清单，写清哪些变量必填、哪些只在服务端使用、哪些可以暴露给前端。部署失败时先对照清单，而不是临时猜变量名。

提交代码前检查

.env 通常不应该提交到公开仓库。可以提交 .env.example，只保留变量名和示例值，真实密钥放在部署平台或本地私有文件里。

如果密钥已经被提交过，即使后来删除，也应该视为泄露并及时轮换。

变量名也要统一

同一个含义不要同时写 API_URL、BASE_URL、SERVER_URL。变量名混乱会让部署和排错变得很痛苦。建议在 README 或部署文档里列出变量用途、示例值和是否必填。

总结

.env 问题常见但隐蔽。检查时要看变量名、空格、注释、引号、换行和环境差异。

上线前可以用 .env 文件检查器 扫一遍格式，再确认生产平台里的变量和本地一致。