当前位置：首页 > news >正文

探秘CommonJS：Node.js模块化核心解析

news 2025/7/28 6:10:47

CommonJS 是 JavaScript 的模块化规范，主要应用于 服务器端环境（尤其是 Node.js），其核心目标是解决代码组织、依赖管理和作用域隔离问题。以下是其核心要点：

同步加载
模块通过 require() 同步加载并执行，后续代码需等待模块加载完成后执行，适用于 I/O 快速的服务器环境（如本地文件读取）。
作用域隔离
每个文件视为独立模块，模块内定义的变量、函数默认私有（不污染全局作用域），仅通过导出接口对外暴露功能。
```
// math.js
const privateVar = 10; // 私有变量
module.exports = { add: (a, b) => a + b + privateVar }; // 导出接口
```

导出与导入语法

导出：使用 module.exports 或 exports 对象（注：exports 本质是 module.exports 的引用）。

// 正确导出（推荐直接赋值 module.exports）
module.exports = { add, subtract }; // 或追加属性（避免 exports 被重写）
exports.add = (a, b) => a + b;

导入：通过 require(模块路径) 同步加载其他模块。

const math = require('./math');
console.log(math.add(1, 2)); // 输出 13（含私有变量值）

缓存机制
模块首次加载后被缓存，后续调用 require() 直接返回缓存结果，避免重复执行。可通过 delete require.cache[modulePath] 清除缓存强制重新加载。

模块包装
Node.js 将模块代码包裹在立即执行函数中，注入 module、exports、require 等变量：
```
(function(exports, require, module, __filename, __dirname) {// 模块代码
});
```
从而实现作用域隔离和局部变量私有化。
路径解析与加载
require() 根据路径规则（./、../、绝对路径或核心模块名）定位文件，按 .js → .json → .node 顺序解析，支持目录加载（优先找 package.json 的 main 字段或 index.js）。
循环依赖处理
当模块 A 依赖 B，B 又依赖 A 时：
- B 加载时会获取 A 的未完成导出对象（此时 A 可能仅执行了部分代码）。
- 依赖执行顺序影响导出结果（需合理设计代码结构避免逻辑混乱）。

历史地位：CommonJS 填补了服务端 JavaScript 模块化的空白，成为 Node.js 的基石。
现代替代：ES Modules（ESM）凭借静态分析、异步加载等优势成为语言标准，逐步取代 CommonJS 。
过渡方案：Node.js 支持 .mjs 扩展名或 package.json 的 "type": "module" 启用 ESM，同时兼容 CommonJS 语法。