如何在使用 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 项目中,便捷地使用传统的目录和文件名路径变量,保持代码的可读性和可维护性。

相关推荐
三小河7 分钟前
在 Codex 桌面端接入 DeepSeek 模型(CC Switch 代理中转)
前端·javascript·人工智能
CoderYanger14 分钟前
前端基础——JavaScript(WebAPI)代码案例
java·开发语言·前端·javascript·css·前端框架·html5
恋猫de小郭22 分钟前
Shopify 从 React Native 回到 Swift/Kotlin,但是你以为有手就行??
android·前端·ios
BillKu1 小时前
Element Plus 的 el-tab-pane:lazy 的说明
前端·javascript·vue.js
爱勇宝1 小时前
《道德经》第 11 章:真正有用的,常常是你没写出来的那部分
前端·后端·产品
jearry1 小时前
WebView2 原生拖放的桥接之道:拆解 yyzTools 的 drop-zone.js
前端·c++
一位正在转型AI全栈的前端工程师1 小时前
AI 全栈学习之旅 -Week 11:从 CLI 到浏览器:用 FastAPI、SSE 和 Vue 3 做一个可审核的 ReAct Agent
前端·python
10share1 小时前
我为什么用 React 重写了一个 VitePress
前端·react.js
计算机魔术师1 小时前
GPT-6 Astra 发布后,Sebastian Raschka 解析 looped transformer 与隐藏推理链传闻
前端
妙码生花1 小时前
golang 应用服务端部署(使用 systemd 服务)
开发语言·人工智能·后端·golang·node.js·php·gin