为何仅在index.ts配置dotenv无效，需每个文件重复配置？

核心原因：模块加载顺序或dotenv配置问题 #

dotenv的config()方法是将.env变量挂载到全局的process.env对象上，理论上只要在所有使用.env变量的模块加载前执行一次，就能全局生效。你遇到的问题大概率是以下几种情况：

1. 导入顺序错误 #

如果你的index.ts中先导入了connectToDatabase.ts这类使用.env变量的模块，再加载dotenv，就会导致这些模块在变量未挂载时就已执行。

修正方案：把dotenv的导入和配置放在index.ts的最顶部，确保它是第一个执行的逻辑：

// index.ts 最顶部优先执行
import dotenv from "dotenv";
dotenv.config();

// 之后再导入其他业务模块
import connectToDatabase from "./connectToDatabase";

// 启动应用逻辑
connectToDatabase();

2. .env文件路径不正确 #

dotenv默认会从项目根目录加载.env文件，如果你的.env不在根目录（比如放在src文件夹下），需要手动指定路径：

dotenv.config({ path: "./src/.env" }); // 替换为你的.env实际路径

3. TypeScript编译/运行时的特殊配置 #

如果使用ts-node或类似工具运行项目，可能需要确保dotenv在编译阶段就加载。可以尝试在启动命令中添加dotenv预加载：

ts-node -r dotenv/config src/index.ts

这种方式不需要在代码中导入dotenv，直接通过命令行参数预加载，避免加载顺序问题。

额外排查点 #

• 检查.env文件的变量格式是否正确（比如DB_URL=xxx，不要加引号或多余空格）
• 在index.ts中添加console.log(process.env)，运行后查看输出是否包含你的.env变量，排除文件本身的问题

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