.env 不生效怎么办

一句话：配置文件没被项目读到

它是什么

.env 不生效，通常是文件名写错、位置放错、变量名不一致、项目没重启，或者代码没有加载 dotenv。它会导致 API Key、端口、模型配置等读不到。可以把 .env 理解成项目的秘密配置本。

适合干什么

• 解决 API Key 读不到
• 配置端口、模型和密钥
• 排查环境变量相关报错

不适合干什么

• 不适合把 .env 上传到公开 GitHub
• 不适合在前端暴露模型 API Key

普通人怎么用

先确认文件名就是 .env，不是 .env.txt；再确认它放在项目要求的位置；最后重启项目。

进阶用户怎么用

可以区分 .env、.env.local、生产环境变量，并在启动时打印非敏感配置检查加载情况。

常见误区

• 误以为改了 .env 会自动生效，很多项目需要重启
• 误以为 API Key 可以写在前端代码里，这是很危险的

和相似工具的区别

• 和 API Key 无效不同：.env 不生效是项目没读到配置，API Key 无效是读到了但密钥错或不可用
• 和端口被占用不同：.env 问题通常是配置加载问题

入门步骤

• 检查 .env 文件名和位置
• 检查变量名是否和代码一致
• 重启项目再测试