es module循环引用本身不报错，但因模块加载顺序和顶层绑定初始化时机导致访问未初始化导出值时抛referenceerror；错误源于let/const未完成赋值的“uninitialized”状态，非tdz或声明未提升。
ES Module 中的循环引用不会直接导致“暂时性死区（TDZ）错误”，但容易让人误以为是 TDZ 问题——实际根源在于 模块加载顺序 和 顶层绑定的初始化时机，而非变量声明未提升（ESM 中声明不提升，但 import 是静态解析、动态绑定）。
循环引用本身不报错，但访问未初始化的导出值会抛 ReferenceError
ESM 的 import 是静态声明、运行时绑定。当模块 A 导入模块 B，B 又导入 A 时，Node.js 或浏览器会按拓扑顺序加载模块，但若在 B 执行过程中试图读取 A 中尚未执行完的顶层变量（比如 const/let 声明但还未赋值），就会触发类似 TDZ 的 ReferenceError。
- A.mjs：export let foo = 'a'; console.log('A loaded'); export const bar = 'bar';
- B.mjs：import { foo } from './A.mjs'; console.log(foo); // 此时 A 的顶层代码可能还没执行完
注意：这个错误不是因为“foo 没声明”，而是因为 foo 虽已声明，但尚未完成初始化赋值（ESM 中顶层 let/const 绑定处于“uninitialized”状态直到执行到对应语句）。
常见触发场景：默认导出 + 同步访问 + 初始化依赖对方
最典型的是两个模块互相导出默认对象，并在顶层立即访问对方导出的属性：
- A.mjs：
import { default as B } from './B.mjs'; export default { init: () => B.ready }; // B.ready 还没定义 - B.mjs：
import A from './A.mjs'; export default { ready: true, run: () => A.init() };
执行时，A 先开始加载，遇到 import B → 进入 B；B 开始执行，尝试 import A → 此时 A 已进入“正在评估”状态，但 export default {...} 还没执行到，所以 B 拿到的是一个空对象或 undefined，后续调用 A.init() 就会失败。
解决方案：延迟访问、解耦初始化、避免顶层强依赖
核心原则是让模块导出“可被安全访问”的值，而不是依赖对方模块已完全执行完毕。
- 用函数封装访问逻辑：把对对方模块的访问放在函数体内（如事件回调、方法调用中），而非顶层同步执行。
- 导出类或工厂函数：避免导出尚未就绪的对象字面量，改用 class 或 createXxx() 函数，将依赖推迟到实例化时。
- 拆分配置与逻辑：把纯数据/常量提取到独立模块（无副作用），让 A/B 只导入该模块，消除直接互引。
- 使用 setter 或事件通知：一方先导出空对象，另一方初始化后主动挂载属性（需谨慎设计生命周期）。
调试技巧：看模块评估状态和错误堆栈
遇到类似错误时，不要只查“TDZ”，而应：
- 检查报错行是否在
import之后、但模块顶层代码尚未执行到该变量赋值处； - 用
console.log在各模块顶部和导出前打点，观察执行顺序； - 在 Node.js 中启用
--trace-module-loading查看模块加载链； - 记住：ESM 中
import不是“执行模块”，而是建立绑定；真正执行靠模块评估（evaluation）阶段。
不复杂但容易忽略。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
