Vite React项目.env变量值无法更新问题求助

• 检查.env文件的环境匹配性
  确认你修改的是对应环境的配置文件：开发环境优先读取.env.development，生产环境读取.env.production，根目录的.env会被这些特定环境文件覆盖。同时再次核对变量名拼写（必须以VITE_开头，且大小写敏感）。

• 清理构建产物与浏览器缓存

  • 删除dist文件夹（如果之前执行过npm run build），避免开发服务器误读旧构建文件中的变量。
  • 打开浏览器开发者工具（F12），在Network面板勾选「Disable cache」后刷新页面，排除浏览器缓存旧JS文件的可能。

• 排查代码中的硬编码值
  全局搜索项目中的旧API地址（http://localhost:8080），确认是否有代码直接写死了该地址，而非使用import.meta.env.VITE_API_URL。

• 验证.env文件的实际内容
  用终端命令cat .env（Linux/macOS）或type .env（Windows）查看文件实际内容，确认修改已保存到磁盘；同时重启IDE，排除IDE缓存旧文件的问题。

• 检查系统环境变量冲突
  在终端执行echo $VITE_API_URL（Linux/macOS）或echo %VITE_API_URL%（Windows），如果输出是旧值，说明系统级环境变量覆盖了本地.env文件的配置，需要删除或修改系统环境变量。

• 重新安装依赖
  删除node_modules文件夹（rm -rf node_modules或rd /s /q node_modules），执行npm install重新安装依赖后再启动项目。

内容的提问来源于stack exchange，提问作者Rolando