Node.js v20内置--env-file无法读取指定.env文件问题求助

从基础点逐步排查，定位并解决问题：

• 检查.env文件格式与属性

  • 确保变量定义无多余空格：必须是HELLO=werld，不能写成HELLO = werld（等号两侧空格会被解析为值的一部分）
  • 确认文件扩展名：保证文件是.env而非隐藏后缀的.env.txt（在文件管理器开启「显示文件扩展名」选项检查）
  • 验证编码：用记事本打开.env，选择「另存为」，确认编码为UTF-8（无BOM），OneDrive同步偶尔会导致编码异常

• 确认Node.js版本与命令正确性

  • 执行node -v确认版本≥v20.6.0：--env-file在v20.6.0才从实验特性转为正式支持，更早的v20版本存在兼容性问题
  • 若路径含空格（OneDrive目录通常带空格），给.env路径加引号：node --env-file=".env" test.js，或直接用绝对路径，比如node --env-file="C:\Users\你的用户名\OneDrive\项目目录\.env" test.js

• 快速验证加载逻辑

  • 跳过test.js直接测试：node --env-file=.env -e "console.log(process.env.HELLO)"
    • 若输出undefined，说明.env未被正确加载；若输出werld，问题出在test.js代码中
  • 测试系统环境变量：执行set HELLO=test（Windows）或export HELLO=test（Mac/Linux），再运行node -e "console.log(process.env.HELLO)"，确认process.env能正常读取变量

• 排查OneDrive同步影响

  • 临时将项目移至非OneDrive目录（如桌面）重新测试，若能正常加载，说明OneDrive同步机制或权限限制导致Node.js无法读取.env
  • 检查.env权限：右键文件→属性→安全，确保当前用户拥有读取权限

• 检查test.js代码

  • 确保代码直接读取并打印，示例：

    console.log(process.env.HELLO);
    

  • 排查是否有其他代码意外覆盖process.env.HELLO

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