【nodejs】“__dirname is not defined”错误修复

news/2025/3/16 23:28:29/

▒ 目录 ▒

    • 🛫 问题
      • 描述
      • 环境
    • 1️⃣ 原理
      • CommonJS vs ESM
      • 错误原因
    • 2️⃣ 禁用 ESM 模式并改用 CommonJS
      • 方案一:项目
      • 方案二:单文件
    • 3️⃣ 在 ESM 模式下自实现__dirname
    • 📖 参考资料

🛫 问题

描述

从网上找了一份代码,其中包含了__dirname变量的使用,结果运行的时候报错:__dirname is not defined

环境

版本号描述
文章日期2023-06-
操作系统Ubuntu 20.04.4 LTSCSDN开发云
node -vv16.17.0npm -v (8.15.0)
Cloud IDE1.71.0
操作系统Win11 - 21H2 - 22000.1335
Python3.7.1
frida.exe15.0.18

1️⃣ 原理

CommonJS vs ESM

讨论__dirname报错,首先要分清楚CommonJS 和 ESM的区别。
CommonJS 和 ESM(ECMAScript Modules) 都是 JavaScript 模块系统的规范,用于组织和管理代码。它们之间有一些区别,下面简要介绍一下:

特点CommonJSESM
加载方式同步加载异步加载
导出/引入关键字module.exports 和 require()export 和 import
支持环境Node.js 默认支持现代浏览器和最新版本的 Node.js 支持
应用范围主要用于服务器端开发,如 Node.js在浏览器端和 Node.js 中有广泛应用,是未来趋势

错误原因

在 CommonJS 模式下,__dirname 是包含当前文件目录变量。 许多Node.js项目都依赖于此变量。
但不能在 ESM 模式下使用(ESM模式不提供 __dirname 变量)。 您有两种选择:

  • 禁用 ESM 模式并改用 CommonJS
  • 聚填充__dirname

2️⃣ 禁用 ESM 模式并改用 CommonJS

在 JavaScript 中,通常文件扩展名 “.js” 用于表示普通的 JavaScript 文件,
而 “.mjs” 用于表示 ECMAScript 模块(ESM)文件。这两种文件扩展名的区别在于它们所代表的 JavaScript 模块类型。

  • .js 文件:通常用来表示普通的 JavaScript 文件,其中可能包含常规的 JavaScript 代码,采用 CommonJS 或其他模块加载方案。
  • .mjs 文件:表示 ECMAScript 模块,这种文件中的代码采用了 ECMAScript Modules(ESM)规范,即使用 “import” 和 “export” 关键字来定义模块。

要使用 “.mjs” 文件,您需要确保在 Node.js 中启用了对 ECMAScript 模块的支持。您可以通过以下几种方式之一实现:

方案一:项目

Node.js 项目中的 package.json 文件是一个用于描述项目信息、依赖关系和脚本命令的 JSON 文件。它位于项目根目录下,是 Node.js 项目的重要配置文件之一。
在 Node.js 项目中的 package.json 文件中,“type” 字段不要设置为 “module”,以明确告知 Node.js 不使用 ESM 规范(或者直接删除)
在这里插入图片描述

方案二:单文件

对于单文件运行node,即不包含 package.json 文件的情况。node是根据文件后缀判断运行模式的。
我们确保文件后缀是.js,而不是.mjs即可使用__dirname。

3️⃣ 在 ESM 模式下自实现__dirname

在 ECMAScript 模块(ESM)中,与 CommonJS 不同,没有像 __dirname 这样的内置变量来表示当前模块的目录路径。不过,您可以通过一些方法来模拟实现类似的功能。

一种常见的方法是使用 import.meta.url 属性来获取当前模块的 URL,然后从中提取出目录路径。下面是一个示例代码,演示如何在 ESM 模式下自实现类似 __dirname 的功能:

import path from 'path';
import { fileURLToPath } from 'url';const __dirname = path.dirname(fileURLToPath(import.meta.url));

在这个示例中,我们首先导入了 Node.js 中的 fileURLToPath 和 dirname 函数,然后使用 import.meta.url 获取当前模块的 URL。接着,通过 fileURLToPath 将 URL 转换为文件路径,并最终通过 dirname 获取该文件路径的目录部分,从而模拟实现了类似 __dirname 的功能。
请注意,这种方法依赖于 Node.js 提供的 url 和 path 模块,确保您的项目中已安装这些模块。这样,您就可以在 ESM 模式下获取当前模块的目录路径,类似于 CommonJS 中的 __dirname 变量。

📖 参考资料

  • How To Fix “__dirname is not defined” Error in Node.js https://masteringjs.io/tutorials/node/__dirname-is-not-defined

http://www.ppmy.cn/news/1373681.html

相关文章

LT6813/ADBMS1818底层驱动---均衡控制

1、LT6813采用内部均衡的原理 2、平衡控制结构体 根据数据库中读取的控制值设置平衡。要为单元设置平衡,必须将相应的位写入配置寄存器中。LTC 驱动程序仅执行数据库中 BMS 写入的数据。 参数 ltc_stateLTC 状态机的状态pSpi接口指向 SPI 配置的指针pTxBuff &…

大数据开发(Hadoop面试真题-卷六)

大数据开发(Hadoop面试真题) 1、MapReduce为什么一定要有环型缓冲区?2、MapReduce为什么一定要有Shuffle过程?3、Reduce怎么知道去哪里拉Map结果集?4、MapReduce Shuffle的排序算法?5、MapReduce shuffle为…

c++虚函数的理解

在C中,虚函数是实现多态性的关键。多态性是指允许不同类型的对象对同一消息做出响应,也就是说,你可以用同一段代码对不同的对象进行操作。 虚函数是通过在基类中使用关键字virtual声明的成员函数。如果在派生类中重新定义基类中的虚函数&…

前端开发报错:Cannot find module ‘@angular-devkit/schematics‘ Require stack:

1、背景 由于近期需要搭建angular ng-zorro-mobile ionic 框架集成项目,但是在开发过程中遇到了报错: Cannot find module angular-devkit/schematics Require stack 2、原因 这里产生的原因是因为我当时遇到另外一个问题,误导我以为是版…

什么是ElasticSearch的深度分页问题?如何解决?

在ElasticSearch中进行分页查询通常使用from和size参数。当我们对ElasticSearch发起一个带有分页参数的查询(如使用from和size参数)时,ElasticSearch需要遍历所以匹配的文档直到达到指定的起始点(from),然后返回从这一点开始的size个文档 在这个例子中: 1.from 参数定义…

vue3 对于watch的再次理解 给响应式变量赋相同值时watch不会被触发。

问题 当我给响应式变量赋相同值时watch不会被触发。 之前一直对于watch的理解是会被频繁触发,值变化就会被执行,反之computed会缓存相同值。 看官方文档也没有相关说明,加上赋相同值的场景占少数 结论 在 Vue 3 中,watch 函数默…

预约自习室

预约自习室 1、技术介绍 自习室预约系统的后端开发语言采用Node,后端开发框架采用Express,数据库采用的Node的最佳搭档MySQL。采用Vue作为前端开发框架,Element-UI作为开发的组件库,微信小程序。期间采用axios实现网页数据获取&a…

实验笔记之——Gaussian Splatting SLAM配置与测试

之前博客对基于3DGS的SLAM进行了调研 学习笔记之——3D Gaussian Splatting及其在SLAM与自动驾驶上的应用调研_3d gaussian splatting slam-CSDN博客文章浏览阅读3.2k次,点赞40次,收藏58次。论文主页3D Gaussian Splatting是最近NeRF方面的突破性工作&a…