本文详解如何通过将模块逻辑封装为函数而非顶层执行语句，规避 ES 模块循环导入导致的 ReferenceError: can't access lexical declaration before initialization 错误，并实现环境参数透传与链式计算。
本文详解如何通过将模块逻辑封装为函数而非顶层执行语句，规避 es 模块循环导入导致的 `referenceerror: can't access lexical declaration before initialization` 错误，并实现环境参数透传与链式计算。
在 JavaScript（尤其是 Deno/ESM 环境）中，当多个模块形成导入环路（如 main → b → a → main），即使实际变量值之间不存在运行时依赖闭环，ES 模块系统仍会因顶层词法绑定的初始化顺序限制而抛出 ReferenceError。根本原因在于：ES 模块在解析阶段就静态声明所有 export 绑定，但其赋值（initialization）必须按依赖拓扑序完成；一旦存在环，部分绑定将处于“已声明但未初始化”状态，此时访问即报错。
上述问题在真实场景中尤为常见——例如需从入口模块（main.js）向下游模块注入运行时环境变量（如 Deno.args[0]），同时又需下游模块（经加工后）反向导出结果供入口使用。直接导出原始值或执行表达式会导致初始化死锁。
✅ 正确解法是：将所有非入口模块的逻辑延迟到函数调用时执行，仅在入口模块保留顶层副作用（如 console.log 和 Deno 调用）。
以下为重构后的可运行方案（适配 Deno）：
立即学习“Java免费学习笔记（深入）”；
main.js（入口模块，允许顶层执行）：
// 从环境获取参数，立即可用
const fromEnvironment = Deno.args[0] ?? '123';
export { fromEnvironment };
import { fromB } from './b.ts';
console.log(fromB()); // ✅ 延迟到此处调用，确保 all deps fully initializeda.ts（纯逻辑模块，无顶层执行）：
import { fromEnvironment } from './main.ts';
export function fromA(): string {
return fromEnvironment + '456'; // 字符串拼接示例
}b.ts（纯逻辑模块，无顶层执行）：
import { fromA } from './a.ts';
export function fromB(): string {
return fromA() + '789';
}? 关键设计原则：
- 入口唯一性：仅 main.js 包含顶层副作用（console.log、Deno.args 读取等），其他模块严格保持“纯函数+命名导出”；
- 延迟求值：所有跨模块数据流转通过函数调用（fromA()、fromB()）完成，绕过模块初始化时序约束；
- 类型安全（TypeScript 友好）：函数签名明确输入输出，便于 IDE 提示与编译检查。
⚠️ 注意事项：
- 切勿在 a.ts 或 b.ts 中写 console.log(...) 或 Deno.env.get(...) 等顶层语句，否则仍会触发初始化错误；
- 若需共享常量（非运行时值），可单独提取至 constants.ts 并避免环形引用；
- 在 Deno 中运行时，请确保使用 .ts 后缀并启用 TypeScript 支持（默认开启）：
deno run main.ts 123 # 输出：123456789
此模式不仅彻底解决循环初始化问题，还提升了代码可测试性——每个函数均可独立单元测试，无需启动整个模块链。本质上，它将“模块依赖”转化为“函数调用依赖”，符合现代 JavaScript 工程的最佳实践。
