ES 模块中无法直接复用 __dirname，因其依赖模块自身 import.meta.url；本文提供可复用的函数式解决方案，通过显式传入 import.meta.url 动态计算调用方所在目录，并附最佳实践与注意事项。
es 模块中无法直接复用 `__dirname`，因其依赖模块自身 `import.meta.url`；本文提供可复用的函数式解决方案，通过显式传入 `import.meta.url` 动态计算调用方所在目录，并附最佳实践与注意事项。
在 CommonJS 环境中，__dirname 是一个自动注入的全局变量，指向当前模块文件所在的绝对路径目录。但在 ES 模块（.mjs 或 type: "module" 的 .js）中，该变量不存在，且无法通过封装成通用导出（如 export const __dirname = ...）来“跨模块复用”——因为一旦写在 utils/__dirname.js 中，它永远解析的是 __dirname.js 自身的位置（即 src/utils），而非调用它的 app.js 所在目录。
✅ 正确解法：函数式 + 显式传参
核心思路是：将路径解析逻辑封装为函数，由每个调用模块自行传入其 import.meta.url。这样既保持了模块化，又确保了路径上下文的准确性。
// dirname.mjs
import { dirname } from 'path';
import { fileURLToPath } from 'url';
export function makeDirname(metaUrl) {
return dirname(fileURLToPath(metaUrl));
}在任意使用位置（如 app.js）：
// app.js
import { makeDirname } from './dirname.mjs';
const __dirname = makeDirname(import.meta.url);
console.log(__dirname); // → 输出 app.js 所在的绝对路径，例如 /project/src? 提示：你也可以为常用路径进一步封装，例如：
export function resolveFromMeta(metaUrl, ...paths) { return join(makeDirname(metaUrl), ...paths); } // 使用：resolveFromMeta(import.meta.url, 'config', 'default.json')
⚠️ 注意事项与最佳实践
- 不可省略 import.meta.url 参数：这是唯一能标识调用模块位置的可靠依据，不能由工具自动推断；
- 避免重命名混淆：虽然我们用 __dirname 作为变量名以保持语义一致性，但它本质是局部常量（const __dirname = ...），不会污染全局作用域；
- Node.js 版本要求：需 Node.js ≥ 12.20.0（推荐 ≥ 14.13.0），确保 import.meta.url 和 fileURLToPath 稳定可用；
- 不推荐“魔法字符串”或 stack 解析：基于 Error.stack 或 require.main 等方式不可靠、性能差且不符合 ESM 设计哲学；
- TypeScript 用户注意：若使用 TS，需在 tsconfig.json 中配置 "moduleResolution": "node" 和 "types": ["node"]，并确保 @types/node 已安装。
✅ 总结
ES 模块没有全局 __dirname，但通过 makeDirname(import.meta.url) 这一两行模式，即可在每个模块中安全、准确地获得自身所在目录。它轻量、透明、无副作用，是目前官方推荐且社区广泛采用的标准实践。与其试图“欺骗”模块系统，不如拥抱 ESM 的显式性——这正是现代 JavaScript 模块设计的初衷。
