当前位置：首页 > 文章列表 > 文章 > 前端 > JavaScript的模块加载器如何实现循环依赖解决？

JavaScript的模块加载器如何实现循环依赖解决？

2026-02-05 22:25:20 0浏览收藏

一分耕耘，一分收获！既然都打开这篇《JavaScript的模块加载器如何实现循环依赖解决？》，就坚持看下去，学下去吧！本文主要会给大家讲到等等知识点，如果大家对本文有好的建议或者看到有不足之处，非常欢迎大家积极提出！在后续文章我会继续更新文章相关的内容，希望对大家都有所帮助！

JavaScript模块系统通过执行时序和缓存机制处理循环依赖，允许模块在部分初始化状态下被引用以避免死锁。CommonJS在运行时同步加载，模块首次require时执行并缓存，循环依赖中可能返回未完全初始化的exports对象，导致获取到undefined值；而ES Module在静态分析阶段建立绑定关系，采用“活绑定”机制，导入变量为只读引用，原始值更新后可反映到导入方。尽管两种格式均能容忍循环依赖，但建议通过重构代码、延迟加载或使用函数导出等方式避免潜在问题。

JavaScript 模块系统在处理循环依赖时，依靠的是模块的执行时机和缓存机制，而不是在解析阶段就完全解决依赖。不同模块格式（如 CommonJS 和 ES Module）处理方式略有不同，但核心思路一致：允许模块在“部分初始化”状态下被引用，避免死锁。

CommonJS 中的循环依赖解决

Node.js 使用 CommonJS 模块系统，其模块是运行时同步加载的，每个模块在第一次 require 时执行并缓存结果。

当出现循环依赖时，例如：

A.js:
const b = require('./B');
console.log('A 获得 B 的值:', b.value);
exports.value = 'a';

B.js:
const a = require('./A');
console.log('B 获得 A 的值:', a.value); // 此时 a 还未完全导出
exports.value = 'b';

执行 A.js 时：

A 开始执行，遇到 require('./B')
B 开始执行，遇到 require('./A')
此时 A 模块已加载但未执行完，exports 对象为空或只有部分属性
B 拿到的是 A 的当前 exports 对象（可能是 {} 或部分导出）
B 继续执行完，导出 value: 'b'
A 接着执行，拿到 B 的完整导出

最终输出可能是：

B 获得 A 的值: undefined
A 获得 B 的值: b

这说明循环依赖没有报错，但可能拿到不完整的值。关键在于模块缓存返回的是一个引用对象，后续更新仍能反映到已引入的模块中。

ES Module（ESM）中的处理方式

ESM 是静态分析、延迟执行的。所有 import 在语法解析阶段确定，模块实例在执行前就建立绑定关系。

ESM 使用“模块记录 + 环形扫描”机制，在进入执行阶段前先构建整个依赖图，确保每个模块都有一个内存位置用于存放导出绑定。

对于循环引用，比如：

// main.js
import { value as valB } from './b.js';
console.log('main got B:', valB);
export const value = 'a';

// b.js
import { value as valA } from './main.js';
console.log('b got A:', valA); // 此时 main 的 value 尚未执行
export const value = 'b';

执行顺序：