ES 模块中无法直接复用 import.meta.url 生成全局 __dirname，因为模块作用域固定；正确做法是导出一个接收 import.meta.url 的函数，在每个调用文件中传入自身元数据，从而精准计算其所在目录。
es 模块中无法直接复用 `import.meta.url` 生成全局 `__dirname`，因为模块作用域固定；正确做法是导出一个接收 `import.meta.url` 的函数，在每个调用文件中传入自身元数据，从而精准计算其所在目录。
在 CommonJS 中，__dirname 是自动注入的变量，指向当前模块所在的绝对目录路径；但在 ES 模块（.mjs 或启用 "type": "module" 的 .js）中，该变量不可用，必须手动通过 import.meta.url + fileURLToPath() + dirname() 组合推导。
然而，将该逻辑封装为独立工具模块并直接 export const __dirname 是无效的——正如示例所示：当你在 utils/__dirname.js 中定义 __dirname，它永远指向 src/utils/，而非导入它的 app.js 所在目录。这是因为 import.meta.url 始终反映定义该变量的模块自身的 URL，而非调用者。
✅ 正确方案：使用函数式、按需计算的方式：
- 创建通用工具函数 makeDirname(metaUrl)，仅负责解析传入的 import.meta.url；
- 在每个需要 __dirname 的模块中，显式调用 makeDirname(import.meta.url)，确保上下文准确。
// dirname.mjs
import { dirname } from 'path';
import { fileURLToPath } from 'url';
export function makeDirname(metaUrl) {
return dirname(fileURLToPath(metaUrl));
}
// app.js
import { makeDirname } from './utils/dirname.mjs';
const __dirname = makeDirname(import.meta.url);
console.log(__dirname); // ✅ 输出 app.js 所在目录，如 /project/src
? 小技巧：可进一步简化为一行声明（推荐用于简洁场景）：
import { makeDirname } from './utils/dirname.mjs';
const __dirname = makeDirname(import.meta.url);
⚠️ 注意事项：
- 不要尝试在工具模块中 export const __dirname = ... —— 这会导致路径“固化”在工具模块位置；
- import.meta.url 是 ESM 唯一可靠的模块定位依据，不可被代理或转发；
- 若项目使用 TypeScript，需确保 tsconfig.json 中 moduleResolution 和 module 配置兼容 Node.js ESM（如 "module": "NodeNext"）；
- 路径结果为 绝对路径（如 /home/user/project/src），可直接用于 fs.readFile、path.join(__dirname, 'config.json') 等操作。
总结：ESM 中没有“动态 __dirname”，但有“动态计算 __dirname”的最佳实践——让每个模块自主提供自己的 import.meta.url，由纯函数处理。这既保持了模块隔离性，又确保了路径准确性，是目前最健壮、可维护的解决方案。
