为何dotenv仅在Express项目部分文件生效？求全局配置方法

Node.js的模块加载是同步执行的，环境变量的注入依赖dotenv读取.env文件并挂载到process.env上。你把dotenv的导入放在app.js中，意味着只有app.js被加载后，环境变量才会被注入。如果其他文件在dotenv完成加载前就已被导入（比如main.js先导入其他文件再导入app.js，或者app.js先导入其他模块再加载dotenv），这些文件执行时process.env还没被注入对应变量，自然读取失败。

要让所有文件都能读取环境变量，核心是让dotenv在项目所有模块加载前完成初始化，具体实现方式如下：

1. 将dotenv放在项目入口文件的最顶部 #

把dotenv的加载代码放在项目启动入口（即你的main.js）的第一行，确保它是第一个被执行的模块：

CommonJS 语法（require） #

// main.js 最顶部
require('dotenv').config();

// 之后再导入其他模块
const app = require('./app');
// 其他文件导入...

ES 模块语法（import） #

如果项目使用ES模块（package.json中设置了"type": "module"），直接在入口顶部导入dotenv/config：

// main.js 最顶部
import 'dotenv/config';

// 之后再导入其他模块
import app from './app.js';
// 其他文件导入...

2. 调整模块导入顺序 #

如果某些文件在dotenv加载前被意外导入（比如app.js先导入路由文件再加载dotenv），需要调整导入顺序，确保dotenv加载代码在所有其他模块导入之前：

// 错误示例：先导入其他模块，再加载dotenv
const userRoutes = require('./routes/user');
require('dotenv').config();

// 正确示例：先加载dotenv，再导入其他模块
require('dotenv').config();
const userRoutes = require('./routes/user');

3. 指定.env文件路径（可选） #

如果你的.env文件不在项目根目录，可以在config方法中指定路径，避免加载失败：

require('dotenv').config({ path: './config/.env' });

修改完成后启动项目，在任意文件中打印对应环境变量（比如console.log(process.env.PORT)），确认是否能正常输出值。

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