不要再把 __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 这个函数的参数,我们的代码其实就是在这个函数中运行,所以可以直接取到它们的值

相关推荐
gCode Teacher 格码致知3 小时前
Javascript提高:get和post等请求,对于汉字和空格信息进行编码的原则-由Deepseek产生
开发语言·前端·javascript·node.js·jquery
用户14860235988724 小时前
MCP Server开发避坑指南:我踩过的8个坑
node.js
Amos_Web7 小时前
Rspack 源码解析 (1) —— 架构总览:从 Node.js 到 Rust 的跨界之旅
前端·rust·node.js
badhope7 小时前
前端已死?前端角色演进的四维技术证据链(2026年实证)
react.js·django·node.js
badhope10 小时前
Ollama、vLLM、Transformers等本地AI平台终极乱斗:手把手教你选对“高达”驾驶舱,拒绝选择困难症!
react.js·程序员·node.js
别看我只是一直狼10 小时前
一套能直接复用的 Playwright 提示词大全
node.js
Arya_aa11 小时前
1.卸载node.js才可以下载nvm,使用nvm更高级,可以指定下载node版本,开发javaweb项目
node.js
winfredzhang13 小时前
从后端架构到移动端体验:拆解一个优雅的 Node.js 轻量级媒体管理系统
架构·node.js·媒体
吴声子夜歌13 小时前
Node.js——npm包管理器
前端·npm·node.js
六月的可乐2 天前
AI Agent:从零构建生产级AI智能体脚手架的架构思考
人工智能·ai·架构·langchain·前端框架·node.js·a