技术求助：__dirname无论在哪个文件或嵌套文件中均返回"/"

常见原因及对应方案 #

1. 采用ES模块（ESM）而非CommonJS #

Node.js中__dirname是CommonJS模块的专属内置变量，如果你在package.json里配置了"type": "module"，所有.js文件会被当作ES模块处理，此时__dirname不会自动存在。若代码未定义就直接使用，可能被全局环境或打包工具默认赋值为根目录"/"。

解决方式二选一：

• 移除package.json中的"type": "module"，切换回CommonJS模块规范；
• 保留ESM，手动实现__dirname的功能：

  import { fileURLToPath } from 'url';
  import { dirname } from 'path';
  const __filename = fileURLToPath(import.meta.url);
  const __dirname = dirname(__filename);
  console.log("__dirname: ", __dirname);
  

2. 打包工具配置重置了路径 #

使用Webpack、Vite等打包工具时，默认配置可能会修改__dirname的值。比如Webpack默认会替换__dirname为构建后的根路径，Vite在构建时也可能做类似优化。

解决方式：

• Webpack：修改webpack.config.js的node选项，禁止替换__dirname：

  module.exports = {
    node: {
      __dirname: false, // 保留原始的__dirname值
    }
  };
  

• Vite：直接改用ESM的手动获取目录方法（同上ESM方案），或者调整Vite的路径相关配置。

3. 全局变量被意外覆盖 #

排查项目中是否有全局脚本、入口文件错误地将__dirname赋值为"/"，比如：

global.__dirname = '/' // Node.js环境
// 或浏览器环境下
window.__dirname = '/'

找到这类代码并移除即可。

4. 运行环境为浏览器而非Node.js #

如果代码是在浏览器环境运行（比如打包后在浏览器中执行），Node.js的__dirname本就不存在，部分打包工具会给它默认赋值为"/"。这种情况要明确场景：

• 若为浏览器环境，文件系统路径无意义，改用相对路径或其他前端路径方案；
• 若为Node.js环境，确保代码未被打包到浏览器环境运行。

内容的提问来源于stack exchange，提问作者Bear Bile Farming is Torture