如何在使用 ES Modules 的 Node.js 应用中创建和使用 __dirname 和 __filename 这两个全局变量

在 Node.js 的 ES Modules (ESM) 环境中,传统的 CommonJS 全局变量 __dirname__filename 不再直接可用。这是因为 ES Modules 采用不同的模块解析策略,更加符合 ECMAScript 标准。因此,如果在使用 ES Modules 格式编写 Node.js 代码,需要使用不同的方法来获取当前模块的文件路径和目录路径。

这段代码演示了如何在使用 ES Modules 的 Node.js 应用中创建和使用 __dirname__filename 这两个全局变量:

javascript 复制代码
import { fileURLToPath } from 'url';  // 引入 url 模块的 fileURLToPath 方法
import { dirname } from 'path';      // 引入 path 模块的 dirname 方法

// 将当前模块的 URL (`import.meta.url`) 转换为本地文件系统路径,并赋值给全局变量 `__filename`
globalThis.__filename = fileURLToPath(import.meta.url);

// 使用 path.dirname 方法获取 __filename 的目录路径,并赋值给全局变量 `__dirname`
globalThis.__dirname = dirname(__filename);

代码详解

  1. import.meta.url:

    • 在 ES Modules 中,import.meta 是一个提供当前模块信息的对象,import.meta.url 返回当前模块的绝对 URL
    • 对于本地文件,这个 URL 会以 file:// 开头。
  2. fileURLToPath(import.meta.url):

    • fileURLToPath() 函数将 URL 字符串转换为对应的本地文件系统路径。这是必须的转换,因为文件系统 API(如 Node.js 的 fs 模块)需要文件路径而不是 URL。
  3. dirname(__filename):

    • dirname() 函数接受一个文件路径作为参数,返回该路径的目录部分。
    • 这里使用它来获取当前模块文件所在的目录路径。

全局变量设置

  • 通过设置 globalThis.__filenameglobalThis.__dirname,这段代码创建了与 CommonJS 环境中相同的全局变量。globalThis 是一个包含所有全局变量的全局对象,它在所有 JavaScript 环境中可用,包括浏览器和 Node.js。

使用场景

  • 这种设置通常用于需要在 ES Modules 环境中迁移或复用依赖于 __dirname__filename 的现有 Node.js 代码。
  • 它允许开发者在不大幅修改代码的情况下,使用模块路径相关功能,如读取相对路径的配置文件、访问相邻的模块或资源等。

通过这种方式,你可以在 Node.js 的 ES Modules 项目中,便捷地使用传统的目录和文件名路径变量,保持代码的可读性和可维护性。

相关推荐
玖釉-3 分钟前
解决PowerShell执行策略导致的npm脚本无法运行问题
前端·npm·node.js
Larcher37 分钟前
新手也能学会,100行代码玩AI LOGO
前端·llm·html
徐子颐1 小时前
从 Vibe Coding 到 Agent Coding:Cursor 2.0 开启下一代 AI 开发范式
前端
小月鸭1 小时前
如何理解HTML语义化
前端·html
jump6801 小时前
url输入到网页展示会发生什么?
前端
诸葛韩信1 小时前
我们需要了解的Web Workers
前端
brzhang2 小时前
我觉得可以试试 TOON —— 一个为 LLM 而生的极致压缩数据格式
前端·后端·架构
yivifu2 小时前
JavaScript Selection API详解
java·前端·javascript
这儿有一堆花2 小时前
告别 Class 组件:拥抱 React Hooks 带来的函数式新范式
前端·javascript·react.js
十二春秋2 小时前
场景模拟:基础路由配置
前端