Node.js 模块加载机制--详解

[Node.js 模块加载机制详解](#Node.js 模块加载机制详解)

[1. 什么是模块？](#1. 什么是模块？)

[2. 模块加载顺序](#2. 模块加载顺序)

[3. 核心模块加载](#3. 核心模块加载)

[4. 自定义模块加载](#4. 自定义模块加载)

[5. 目录作为模块（index.js）](#5. 目录作为模块（index.js）)

[6. require.resolve() 查找模块路径](#6. require.resolve() 查找模块路径)

[7. module 对象解析](#7. module 对象解析)

[8. require.cache 机制（避免重复加载）](#8. require.cache 机制（避免重复加载）)

[9. 加载 JSON 模块](#9. 加载 JSON 模块)

[10. 加载第三方模块](#10. 加载第三方模块)

结论

这里是一篇关于 Node.js 模块加载机制 的详细介绍，适合作为博客发布。它涵盖了模块加载的基本概念、加载顺序、核心模块、自定义模块、第三方模块等内容，并包含完整代码示例。

Node.js 模块加载机制详解

1. 什么是模块？

在 Node.js 中，模块（Module）是一个独立的 JavaScript 文件，封装了一些功能，使代码更易复用和管理。Node.js 提供了三类模块：

核心模块（Core Module） ：Node.js 自带的，如 fs、path、http。
文件模块（File Module） ：用户自定义的 JavaScript 文件，如 moduleA.js。
第三方模块（Third-party Module） ：通过 npm 安装的，如 express、lodash。

2. 模块加载顺序

Node.js 使用 require() 方法加载模块，其加载顺序如下：

先检查 核心模块 ，如 fs、path。
如果不是核心模块，则按照 文件或目录 查找：
- 先尝试加载 相对路径 或 绝对路径 文件，如 require('./moduleA')。
- 如果是文件模块，会自动补全 .js、.json、.node 后缀。
- 如果是目录，会查找 package.json 里的 main 字段或 index.js。
如果未找到文件，则在 node_modules 目录 查找。

3. 核心模块加载

核心模块是 Node.js 自带的，可以直接 require：

示例：加载 fs 模块读取文件

📄 文件名：coreModule.js

javascript 复制代码

const fs = require('fs'); // 加载核心模块
const data = fs.readFileSync(__filename, 'utf-8'); // 读取当前文件内容
console.log(data);

📌 运行结果 ：会打印 coreModule.js 文件的内容。

4. 自定义模块加载

Node.js 默认采用 module.exports 和 require 进行模块化管理。

📄 文件名：math.js（自定义模块）

javascript 复制代码

// 定义一个数学运算模块
function add(a, b) {
    return a + b;
}

function subtract(a, b) {
    return a - b;
}

// 导出模块
module.exports = {
    add,
    subtract
};

📄 文件名：main.js（主文件，调用 math.js）

javascript 复制代码

const math = require('./math'); // 加载自定义模块

console.log(math.add(5, 3));     // 输出: 8
console.log(math.subtract(5, 3)); // 输出: 2

📌 运行结果：

bash 复制代码

8
2

5. 目录作为模块（`index.js`）

如果 require() 引用了一个目录，则默认加载 index.js 或 package.json 中 main 指定的文件。

📁 目录结构：

javascript 复制代码

/myModule
  ├── index.js
  ├── math.js
  └── main.js

📄 文件名：index.js（目录的默认入口文件）

javascript 复制代码

module.exports = require('./math'); // 让目录直接导出 math.js

📄 文件名：main.js（测试）

javascript 复制代码

const math = require('./myModule'); // 直接加载目录
console.log(math.add(10, 2)); // 输出: 12

📌 运行结果：

bash 复制代码

6. `require.resolve()` 查找模块路径

require.resolve() 可以查看某个模块的完整路径。

📄 文件名：resolve.js

javascript 复制代码

console.log(require.resolve('fs')); // 核心模块
console.log(require.resolve('./math')); // 本地模块

📌 运行结果：

javascript 复制代码

fs
/path/to/math.js

7. `module` 对象解析

Node.js 内部有一个 module 对象，可以查看当前模块信息。

📄 文件名：moduleInfo.js

javascript 复制代码

console.log(module); // 打印当前模块信息

📌 运行结果（部分信息）：

javascript 复制代码

{
  "id": ".",
  "exports": {},
  "parent": null,
  "filename": "/path/to/moduleInfo.js",
  "loaded": false
}

8. `require.cache` 机制（避免重复加载）

Node.js 会缓存已经加载的模块，以提高性能。如果需要强制重新加载，可以删除缓存。

📄 文件名：cacheTest.js

javascript 复制代码

const math = require('./math');
console.log(math.add(2, 2)); // 第一次加载

delete require.cache[require.resolve('./math')]; // 清除缓存

const mathNew = require('./math'); 
console.log(mathNew.add(3, 3)); // 重新加载

📌 运行结果：

bash 复制代码

4
6

9. 加载 JSON 模块

📄 文件名：data.json

javascript 复制代码

{
  "name": "NodeJS",
  "version": "1.0.0"
}

📄 文件名：loadJSON.js

javascript 复制代码

const data = require('./data.json'); // 直接加载 JSON
console.log(data.name); // 输出: NodeJS
console.log(data.version); // 输出: 1.0.0

📌 运行结果：

bash 复制代码

NodeJS
1.0.0

10. 加载第三方模块

步骤：

使用 npm install lodash 安装 lodash 模块。
代码示例：

📄 文件名：thirdParty.js

javascript 复制代码

const _ = require('lodash'); // 加载 lodash 库
console.log(_.capitalize('hello world')); // 输出: Hello world

📌 运行结果：

bash 复制代码

Hello world

结论

Node.js 的模块加载机制非常灵活，通过 require() 可以加载核心模块、自定义模块和第三方模块。它的查找顺序是 核心模块 → 文件模块 → node_modules，并且具有缓存机制，提高了加载效率。

学习和掌握这些模块机制，有助于更高效地开发 Node.js 应用！ 🚀