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() 手动推导。

然而，将推导逻辑封装在独立工具模块（如 utils/__dirname.js）并直接导出 __dirname 常量是无效的——因为该常量总是在工具模块自身执行时求值，结果永远是工具模块所在路径（如 src/utils），而非调用方路径（如 src/app.js 所在的 src/）。

✅ 正确解法：使用函数式封装 + 显式传参
将路径解析逻辑封装为纯函数，由调用方传入自身的 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 './dirname.mjs';

const __dirname = makeDirname(import.meta.url);
console.log(__dirname); // → /full/path/to/your/project/src (即 app.js 所在目录)

⚠️ 注意事项：

• 必须在每个需要 __dirname 的模块中单独调用 makeDirname(import.meta.url)，无法“一次定义、全局复用”；
• import.meta.url 是只读的模块元数据，不能被修改或代理，因此无法通过 Proxy 或动态 import 绕过显式传参；
• 若项目使用 TypeScript，建议为 makeDirname 添加类型声明（metaUrl: ImportMeta['url']），提升类型安全性；
• 不推荐通过 new Error().stack 或 caller 等非标准方式反向推导调用路径——既不可靠，也违背 ES 模块设计原则。

这种模式虽需每处写两行代码（导入 + 调用），但语义清晰、行为确定、完全符合模块隔离规范，是目前 Node.js 官方推荐且最稳健的替代方案。