Node.js中dirname和filename变量究竟有何奥秘？

2026-03-31 13:531阅读0评论SEO基础

内容介绍
文章标签
相关推荐

本文共计951个文字，预计阅读时间需要4分钟。

本文带大家了解一下Node.js中你可能不知道的`__dirname`和`__filename`变量，它们具有一定的参考价值，希望对大家有所帮助！

1. 问题背景今天在遇到一个神级的报错，一起来往下看吧。

2. `__dirname`和`__filename`简介在Node.js中，`__dirname`和`__filename`是全局变量，分别表示当前执行文件的目录路径和文件名。

3. 参考价值 - `__dirname`可以帮助你获取当前文件的目录路径，这在文件操作或模块化开发中非常有用。 - `__filename`可以获取当前文件的绝对路径，这对于文件定位和错误处理很有帮助。

4. 使用示例javascriptconsole.log(__dirname); // 输出当前文件的目录路径console.log(__filename); // 输出当前文件的绝对路径

5. 注意事项 - `__dirname`和`__filename`的值是相对于执行文件的起始路径，而不是当前工作目录。 - 在模块中，`__dirname`和`__filename`的值是模块文件的路径。

希望这篇文章能帮助你更好地理解`__dirname`和`__filename`这两个变量，并在实际开发中发挥它们的作用！

本篇文章带大家了解一下node中你不知道的__dirname和__filename变量，有一定的参考价值，希望对大家有所帮助！

1.问题背景

写这篇文章的背景在于今天遇到一个神奇的报错，一起来看下

// index.js console.log(__filename); // 执行 node index.js // ReferenceError: __filename is not defined in ES module scope

在node环境访问全局变量__filename居然报错，什么原因呢？？于是开始了一路的探索，最终找到问题的根源。

2. node模块机制

我们知道早期node.js的模块标准采用commonjs模块规范，然而在nodejs版本v13.2.0中，开始支持ES Modules模块规范，我们可以有以下几种方式在node中使用ES Modules模块

将文件后缀命名为.mjs
package.json 新增 "type": "module"字段

当我们在node中使用ES Modules贵方，以下全局对象和变量将不可用

require
module.exports
exports
__filename
__dirname
NODE_PATH

3. 为什么采用commonjs模块化可以使用__filename和__dirname?

这个问题，主要归结于commonjs模块下nodejs的运行机制，很多人可能认为__filename就是node环境中的全局变量，当出现这个问题的时候，我们才意识到，这两个不是Node中真正的全局变量。

看一段简单的js代码

(function(){ console.log(arguments) // [1,2,3] })(1,2,3)

arguments在函数内部可以拿到调用函数时传入的参数。

我们在node commonjs模块中执行以下代码

// index.js console.log(arguments); [Arguments] { '0': {}, '1': [Function: require] { resolve: [Function: resolve] { paths: [Function: paths] }, main: Module { id: '.', path: 'E:\\nodeProjectStorehouse\\nodeStudyFromBook', exports: {}, filename: 'E:\\nodeProjectStorehouse\\nodeStudyFromBook\\cc.cjs', loaded: false, children: [], paths: [Array] }, extensions: [Object: null prototype] { '.js': [Function (anonymous)], '.json': [Function (anonymous)], '.node': [Function (anonymous)] }, cache: [Object: null prototype] { 'E:\\nodeProjectStorehouse\\nodeStudyFromBook\\cc.cjs': [Module] } }, '2': Module { id: '.', path: 'E:\\nodeProjectStorehouse\\nodeStudyFromBook', exports: {}, filename: 'E:\\nodeProjectStorehouse\\nodeStudyFromBook\\cc.cjs', loaded: false, children: [], paths: [ 'E:\\nodeProjectStorehouse\\nodeStudyFromBook\\node_modules', 'E:\\nodeProjectStorehouse\\node_modules', 'E:\\node_modules' ] }, '3': 'E:\\nodeProjectStorehouse\\nodeStudyFromBook\\cc.cjs', '4': 'E:\\nodeProjectStorehouse\\nodeStudyFromBook'

我们可以看到，arguments有5个参数，这5个参数就是exports, require, module, __filename, __dirname

到这里我们就清楚的知道，__filename不是全局变量，而是外层传入的参数而已

既然这样，我们在ES Modules模块下，访问arguments看下结果是什么？

// index.js ES modules console.log(arguments); // ReferenceError: arguments is not defined4. ES Modules下如何使用__filename和__dirname?

node官方文档建议使用import.meta.url变相的提供

// import.meta.url 返回模块的绝对的 `file:` URL。 // url模块中fileURLToPath()函数，返回完全解析的特定于平台的 Node.js 文件路径 // path模块中dirname()函数，返回路径的目录路径 import { fileURLToPath } from 'url'; import { dirname } from 'path'; const __filename = fileURLToPath(import.meta.url); const __dirname = dirname(__filename);

更多node相关知识，请访问：nodejs 教程！！

标签：dirname 和 filenam