多文件导出环境变量触发Cannot access before initialization报错如何解决

错误成因 #

该报错是ES模块循环依赖+导出顺序不匹配导致的初始化时序问题：

1. 引入公共库时会优先加载公共库根目录的index.js，该文件的导出顺序为：先导出Services模块，再导出Env模块。
2. 加载Services/index.js时，代码通过import { SECRET_CREDENTIALS } from ".."从根索引导入环境变量，此时根索引的Env导出逻辑还未执行，SECRET_CREDENTIALS处于未初始化状态。
3. const KEY = SECRET_CREDENTIALS.mykey属于顶层执行代码，会在模块加载阶段直接运行，此时访问未初始化的变量就会抛出对应报错。
4. 将赋值逻辑移入showVar内部后，代码仅会在showVar被调用时执行，此时所有模块都已加载完成，SECRET_CREDENTIALS已经初始化完毕，报错自然消失。

解决方案 #

可按优先度选择以下三种调整方式：

• 修改Services模块的导入路径，彻底规避循环依赖：将import { SECRET_CREDENTIALS } from ".."替换为import { SECRET_CREDENTIALS } from '../Env'，直接指向Env模块的实际路径，不需要依赖根索引的导出顺序，稳定性最高。
• 调整公共库根index.js的导出顺序：将原来的导出顺序调换，先导出Env再导出Services，代码如下：

export * from './Env'
export * from './Services'

该方式调整成本极低，加载Services前Env已经完成导出初始化，顶层赋值逻辑可正常执行。

• 保留延迟初始化写法：如果变量不需要在模块加载阶段预先计算，可以将取值逻辑封装到函数内部或者懒加载getter中，仅在调用时才取值。

内容的提问来源于stack exchange，提问作者David Min