Node.js 模块导入的基本流程

Node.js 模块导入的基本流程,主要是 CommonJS 模块加载机制 (即使用 require())的内部执行步骤。下面我用清晰的结构给你梳理一下这个过程:


✅ Node.js 模块导入的基本流程(使用 require()

js 复制代码
const someModule = require('./someModule');

👣 加载流程详解:


解析模块路径

  • Node.js 会先判断传入的是:
    • 核心模块 (如 fs, http 等);
    • 第三方模块(node_modules 中找);
    • 相对路径模块 (以 ./../ 开头);
    • 绝对路径模块 (如 /Users/...)。

定位文件(模块路径解析)

  • 以相对路径为例:require('./someModule'),Node.js 会尝试依次查找以下几种形式:
bash 复制代码
./someModule.js
./someModule.json
./someModule.node
./someModule/index.js   # 如果是目录

缓存检查

  • Node.js 会先查看该模块是否已在 缓存 中(require.cache)。
  • 如果存在缓存,则直接返回缓存结果(即模块导出的对象)。

编译模块

  • Node.js 根据不同文件类型执行不同的加载方式:
文件类型 加载方式
.js 作为 JavaScript 代码加载(包一层函数)
.json 使用 JSON.parse() 解析为对象
.node 使用 C++ 插件方式加载(动态链接库)
  • 对于 .js 文件,Node.js 会将模块代码包装成如下形式:
js 复制代码
(function(exports, require, module, __filename, __dirname) {
  // 原始模块代码
})

这叫做 模块包装(Module Wrapper),让模块拥有自己的作用域。


执行模块代码

  • 在模块包装完成后,Node.js 执行模块代码,并把 module.exports 作为结果返回。

返回 exports 对象

  • 最终,require() 返回的是 module.exports 的内容。

💡 一个完整的生命周期图示(简略):

text 复制代码
require() 调用
   ↓
路径解析
   ↓
缓存检查(require.cache)
   ↓
文件定位(.js/.json/.node)
   ↓
模块包装(function wrapper)
   ↓
模块执行(module.exports)
   ↓
结果返回

🧠 补充:模块缓存细节

  • 所有加载过的模块都会被缓存(除非手动清理):

    js 复制代码
    delete require.cache[require.resolve('./someModule')];
相关推荐
csdn_aspnet9 小时前
Node.js 使用 WebSockets 和 Socket.IO 实现实时聊天应用程序
node.js
whhhhhhhhhw13 小时前
Node.js核心API(fs篇)
node.js
聪聪的学习笔记13 小时前
【1】确认安装 Node.js 和 npm版本号
前端·npm·node.js
GDAL21 小时前
Node.js v22.5+ 官方 SQLite 模块全解析:从入门到实战
数据库·sqlite·node.js
RunsenLIu1 天前
基于Vue.js + Node.js + MySQL实现的图书销售管理系统
vue.js·mysql·node.js
Allen_zx1 天前
Elpis - 基于 Koa + Vue3 的企业级全栈应用框架
node.js
鹏程1 天前
局域网下五子棋,html+node.js实现
node.js·html
爱分享的程序员1 天前
前端面试专栏-算法篇:17. 排序算法
前端·javascript·node.js
盛夏绽放1 天前
接口验证机制在Token认证中的关键作用与优化实践
前端·node.js·有问必答
GDAL1 天前
Node.js REPL 教程
node.js·编辑器·vim