JavaScript模块循环依赖不会语法报错但会导致undefined或不完整对象，因ESM静态求值和CommonJS执行时机问题；修复首选重构拆分、次选延迟获取、三选CommonJS动态赋值。
JavaScript 模块循环依赖本身不会直接报错，但会导致模块导出值为 undefined 或不完整对象，引发运行时错误——问题不在语法，而在执行时机和模块状态。
循环依赖为什么出问题？
ES 模块（ESM）在加载时会先解析、执行顶层代码，并按导入顺序“静态求值”。当 A 依赖 B，B 又依赖 A 时：
- A 开始执行，遇到
import { x } from './B.js'，暂停执行，跳转去加载并执行 B - B 开始执行，遇到
import { y } from './A.js'，此时 A 还没执行完，只导出了已初始化的部分（未声明的变量是undefined，export default若还没走到那行就是undefined） - B 用到了 A 中尚未初始化的导出，拿到
undefined，后续逻辑可能崩溃
CommonJS 虽然允许“边执行边导出”，但若 B 在 A 的模块体中提前读取了 A 的导出（比如函数调用），而 A 还没来得及赋值，同样会得到 undefined 或空对象。
常见修复方式（按推荐优先级）
1. 重构拆分：把共享逻辑提到第三个模块
最干净彻底的解法。把 A 和 B 共同依赖的数据、工具函数、类型定义等，抽到一个独立模块 C 中，A 和 B 都只依赖 C，不再互相依赖。
2. 延迟获取：用函数或 getter 封装依赖
避免在模块顶层直接读取对方导出，改为在实际需要时才调用：
- 在 B 中不直接
import { something } from './A.js'，而是定义一个函数getFromA() { return require('./A.js').something }（CommonJS）或async function getFromA() { const mod = await import('./A.js'); return mod.something }（ESM 动态导入） - 或改用
export const something = { get value() { return A.someValue } }（getter 延迟到访问时求值）
3. 默认导出 + 对象属性赋值（仅限 CommonJS）
利用 CommonJS 的 module.exports 可中途修改特性：
- A.js：
module.exports = {}; module.exports.fn = () => {...} - B.js：
const A = require('./A.js'); console.log(A.fn); // OK，即使 A 还没执行完 - 注意：这要求 A 必须先导出空对象，再逐步挂载属性，且不能用
export default语法
如何快速发现循环依赖？
开发阶段可借助工具主动检测：
立即学习“Java免费学习笔记（深入）”；
- Webpack：开启
stats.dependencyGraph: true，或使用插件webpack-circular-dependency-plugin - Vite / Rollup：默认会在构建时报出循环依赖警告（如 “Circular dependency”）
- Node.js（ESM）：启动时加
--trace-warnings，部分循环会触发提示 - 静态分析：用
madge --circular --extensions js,ts ./src
别等线上报 Cannot read property 'xxx' of undefined 才排查——循环依赖的错误表现往往滞后且难以定位。
基本上就这些。循环依赖不是语法禁区，但它是设计信号：两个模块耦合太紧，该理清职责边界了。
