JavaScript中的模块循环依赖是如何被解析的？-js教程-PHP中文网

JavaScript中的模块循环依赖是如何被解析的？

betcha

发布： 2025-10-09 11:52:02

原创

862人浏览过

循环依赖指模块A引用模块B的同时B也引用A，JavaScript通过先注册后执行的机制处理：ESM在加载时解析声明但不执行，遇到循环依赖时确保模块记录存在，执行时若依赖未完成则返回undefined。如a.js和b.js互相导入，先执行的模块中导入值为undefined，因对方尚未初始化。解决方式包括重构共用逻辑、使用函数延迟访问或避免顶层直接使用导入值。CommonJS同理，require可能返回未完整导出的对象。理解该机制可避免读取未初始化值的问题。

javascript中的模块循环依赖是如何被解析的？

JavaScript中的模块循环依赖是通过模块执行顺序和导出绑定的延迟性来处理的。当两个或多个模块相互引用时，JavaScript引擎并不会让程序崩溃，而是采用一种“先注册、后执行”的策略来解析这种依赖关系。

什么是循环依赖？

循环依赖指的是模块A导入了模块B，而模块B又反过来导入了模块A。例如：

// a.js
import { bValue } from './b.js';
export const aValue = 'A';
console.log('In a.js, bValue is:', bValue);

// b.js
import { aValue } from './a.js';
export const bValue = 'B';
console.log('In b.js, aValue is:', aValue);

在这个例子中，a.js 和 b.js 相互导入对方，形成循环依赖。

模块解析机制如何应对循环依赖？

JavaScript 模块系统（ESM）使用静态分析 + 执行时机分离的方式来处理循环依赖：

立即学习“Java免费学习笔记（深入）”；

所有模块在加载时都会先创建一个模块记录，并解析导入/导出声明，但不会立即执行代码
当发现循环依赖时，JavaScript 引擎会优先完成模块的初始化注册，然后按依赖链逐步执行
如果某个模块还未执行完就被另一个模块导入，那么导入的值可能是尚未初始化的状态（如 undefined）

以上面的例子运行结果为例：

In b.js, aValue is: undefined
In a.js, bValue is: B

原因在于：a.js 先被触发执行 → 加载 b.js → 执行 b.js 中的导入 → 此时 a.js 还未执行到定义 aValue 的语句，所以 aValue 是 undefined。等 b.js 执行完毕后，再回到 a.js 继续执行，此时 bValue 已经可用。

如知AI笔记

如知笔记——支持markdown的在线笔记，支持ai智能写作、AI搜索，支持DeepseekR1满血大模型

查看详情

如何安全处理循环依赖？

虽然 JavaScript 能解析循环依赖，但容易导致读取到未初始化的值。建议采取以下方式避免问题：

重构代码结构：将共用逻辑提取到第三个模块中，打破循环
使用函数或 getter 延迟访问：把需要导出的值包装成函数，确保调用时才读取
避免在顶层直接使用导入的值进行计算：尤其是涉及副作用或日志输出时要小心

比如改写为函数导出：

// a.js
import { getBValue } from './b.js';
export const aValue = 'A';
console.log('In a.js, bValue is:', getBValue());

// b.js
import { aValue } from './a.js';
export function getBValue() {
return 'B';
} export const bValue = 'B';