Node.js/Express.js（ES模块）无需重复引入dotenv访问.env的方法

问题场景 #

项目package.json已设置"type": "module"，当前每个需要访问process.env的文件都必须重复执行以下代码：

import dotenv from 'dotenv';
dotenv.config();

相关代码片段：

import validator from 'validator';
import { Users } from '../../models/auth.js';
import { jwtSignPromise } from '../../utils/jasonWebToken.js';

import dotenv from 'dotenv';
dotenv.config();
const JWT_KEY = process.env.SECRET_KEY;

export const login = async (req, res) => {
    const initialStateResponse = {
        userName: null,
        token: null,
        // ........ more code ..............
    }
    // ... 业务逻辑
};

解决方案 #

以下几种方法可避免重复配置dotenv，实现全局访问环境变量：

1. 在项目入口文件一次性配置dotenv

找到项目入口文件（如app.js、index.js），在最顶部完成dotenv的导入和配置，后续所有模块会自动继承已注入的环境变量，无需重复操作。

示例代码：

// app.js（项目入口）
import dotenv from 'dotenv';
dotenv.config();

// 后续正常导入业务模块
import express from 'express';
import { login } from './routes/auth.js';

const app = express();
// ... 其他启动逻辑

2. 使用dotenv/config简化导入

直接通过import 'dotenv/config';替代手动调用dotenv.config()，一行代码完成环境变量加载，同样放在入口文件顶部即可。

示例：

// 项目入口文件顶部
import 'dotenv/config';

// 正常导入其他依赖和模块
import { Users } from './models/auth.js';
// ...

3. 封装环境变量模块（适合复杂场景）

创建专门的环境变量处理模块，集中加载并导出所需变量，其他模块直接导入该模块的变量即可，无需直接操作process.env。

示例：

// utils/env.js
import dotenv from 'dotenv';
dotenv.config();

// 可添加变量校验、默认值设置逻辑
export const JWT_KEY = process.env.SECRET_KEY || 'default_jwt_key';
export const DB_URL = process.env.DATABASE_URL;
// 导出其他需要的环境变量

业务模块中使用：

import validator from 'validator';
import { Users } from '../../models/auth.js';
import { jwtSignPromise } from '../../utils/jasonWebToken.js';
import { JWT_KEY } from '../../utils/env.js';

export const login = async (req, res) => {
    // 直接使用JWT_KEY
    // ... 业务逻辑
};

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