不要再把 __dirname、__filename 当全局变量了!

__dirname、__filename 到底是不是全局变量?

node.js 官网给出的答案:不是!

模块作用域

__dirname、__filename 其实是模块作用域

  • __dirname:是当前模块的目录名
  • __filename:是当前模块的文件名
  • exports:对module.exports 的引用,关于 exports 和 module.exports 此篇
  • module:对当前模块的引用
  • require:用于导入模块、JSON 和本地文件
javascript 复制代码
// test.js 位于 E:\projects\node\node-demo目录下,在当前目录执行 node test.js
console.log("__dirname", __dirname);
console.log("__filename", __filename);
console.log("exports", exports);
console.log("module", module);
console.log("require", require);

打印结果如下:

为什么可以直接取到 __dirname、__filename ?

既然 __dirname、__filename 不是全局变量,那它们哪来的?为什么可以直接取到?

来,上源码

javascript 复制代码
// node\lib\internal\modules\cjs\loader.js
Module.prototype._compile = function(content, filename) {
  ......
  const compiledWrapper = wrapSafe(filename, content, this);
  ......
};

let wrap = function(script) { // eslint-disable-line func-style
  return Module.wrapper[0] + script + Module.wrapper[1];
};

const wrapper = [
  '(function (exports, require, module, __filename, __dirname) { ',
  '\n});',
];

function wrapSafe(filename, content, cjsModuleInstance, codeCache) {
  ......
  if (patched) {
    const wrapped = Module.wrap(content);
    const script = makeContextifyScript(
      wrapped,                 // code
      filename,                // filename
      0,                       // lineOffset
      0,                       // columnOffset
      undefined,               // cachedData
      false,                   // produceCachedData
      undefined,               // parsingContext
      hostDefinedOptionId,     // hostDefinedOptionId
      importModuleDynamically, // importModuleDynamically
    );
    ......
    return runScriptInThisContext(script, true, false);
  }

  const params = [ 'exports', 'require', 'module', '__filename', '__dirname' ];
  try {
    const result = internalCompileFunction(
      content,                           // code,
      filename,                          // filename
      0,                                 // lineOffset
      0,                                 // columnOffset,
      codeCache,                         // cachedData
      false,                             // produceCachedData
      undefined,                         // parsingContext
      undefined,                         // contextExtensions
      params,                            // params
      hostDefinedOptionId,               // hostDefinedOptionId
      importModuleDynamically,           // importModuleDynamically
    );
    ......
    return result.function;
  } catch (err) {
    ......
  }
}

重点就是 wrapSafe()、wrap()、wrapper

编译时,_compile 调用 wrapSafe ,wrapSafe 这个函数将 content 包装在一个脚本(wrapper)中,并在新的上下文中运行它,这个 content 就是我们写的 js 文件中的内容

比如 app.js 中有代码 console.log(__dirname);

当执行 node app.js,开始编译这个文件,wrapSafe 函数会将这个 js 文件中的所有内容先拼接成 '(function (exports, require, module, __filename, __dirname) { console.log(__dirname); \n});' 这样一个字符串(即调用 Module.wrap(content)),再将它转化为一个可执行脚本(即调用 makeContextifyScript),然后在当前上下文中执行(即调用 runScriptInThisContext)

由源码可以看到,exports, require, module, __filename, __dirname 就是 wrapSafe 这个函数的参数,我们的代码其实就是在这个函数中运行,所以可以直接取到它们的值

相关推荐
hoLzwEge2 天前
pnpm vs npm:新一代包管理器的范式革命
前端框架·node.js
麻辣凉茶2 天前
给阿嬤一封来自云端的信(上)
前端·node.js
codingWhat3 天前
能效平台设计方案(打通gitlab和飞书)
后端·node.js·koa
见过夏天4 天前
Node.js 常用命令全攻略
node.js
前端双越老师5 天前
我从 0 开发的 AI Agent 智语项目发布了
前端·node.js·agent
kyriewen5 天前
2026 年了,还在用 Node.js?Bun 迁移实战:20 分钟搞定,附踩坑记录
前端·javascript·node.js
donecoding6 天前
3 条命令搞定闭环 Monorepo:Lerna 版本管理 + 拓扑构建 + 自定义分发
前端·前端框架·node.js
Flynt7 天前
npm v12 来了:allowScripts 默认关闭,我的项目差点跑不起来
安全·npm·node.js
叫我Paul就好8 天前
尝试 Node 搭建后端-开发框架
node.js
风止何安啊9 天前
网课倍速痛点解决:一套前端代码实现自由控速播放器
前端·javascript·node.js