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 时:
立即学习“Java免费学习笔记(深入)”;
- 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.jsimport { 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';
执行顺序:
- 解析所有 import/export,建立绑定映射
- 开始执行 main.js,但先执行依赖 b.js
- b.js 执行,尝试读取 main.js 的 value
- 此时 main.js 的 value 还未定义(执行未完成),所以值为 undefined
- b.js 输出 undefined,并导出自己的 value
- main.js 继续执行,输出 b 的值
输出结果:
b got A: undefined main got B: b
ESM 的关键是活绑定(live binding):导入的变量是原始变量的只读引用,如果原始值后续变化,导入方也能看到(适用于 const/let/const 声明的导出)。
如何避免循环依赖带来的问题
虽然 JavaScript 能处理循环依赖,但容易导致逻辑错误或意外的 undefined。建议:
- 重构代码结构,打破环状依赖,比如提取公共逻辑到第三方模块
- 延迟访问依赖项,例如在函数内部 require,而不是模块顶层
- 使用 getter 或函数返回值,避免直接导出原始值
- 在 ESM 中,确保导出声明在使用前已定义
基本上就这些。JavaScript 模块加载器通过模块缓存和执行时序来“容忍”循环依赖,而不是彻底消除它。理解其机制有助于写出更健壮的模块代码。










