因目录结构导致的TSC编译异常问题排查与代码组织方案

拆分文件后触发TypeError: Class extends value undefined is not a constructor or null，核心问题是循环依赖引发的模块加载顺序异常。

当类拆分到独立文件后，若存在继承链（比如C extends B、B extends A）或交叉引用关系，模块加载时如果子类所在文件先被执行，此时父类所在模块还未完成导出初始化，子类尝试继承的父类值会是undefined，从而抛出该错误。而单文件场景下所有类处于同一作用域，不存在加载顺序问题，因此可以正常运行。

1. 排查并消除循环依赖 #

• 梳理模块间的引用关系，若存在A引用B、B又引用A的循环依赖，将两者共用的逻辑（如公共工具、基础类型）抽离到独立模块（比如common.ts），让A和B都引用这个公共模块，替代互相引用。
• 若为线性继承链（如A→B→C），确保父类模块在子类之前被加载，避免在模块顶级作用域直接依赖未初始化的父类。

2. 调整模块导入导出逻辑 #

• 对非继承场景的交叉依赖，使用延迟导入：在需要使用的函数或方法内部动态导入依赖模块，而非在模块顶部静态导入。示例：

// B.ts
class B {
  async handleLogic() {
    const { A } = await import('./A');
    const aInstance = new A();
    // 后续逻辑
  }
}

• 继承场景下，确保父类的导入语句放在子类定义之前，比如C.ts中先写import { B } from './B'，再定义class C extends B。

3. 统一管理接口文件 #

• 将所有接口集中存放在单独的interfaces/目录下（比如interfaces/ABC.ts），所有类文件统一从该目录导入接口。这种方式既避免接口分散导致的引用混乱，也能减少类文件之间的直接依赖。推荐项目结构：

src/
├── interfaces/
│   └── ABC.ts       # 存放所有相关接口
├── A.ts             # 类A
├── B.ts             # 类B（继承A）
└── C.ts             # 类C（继承B）

4. 用类型导入优化依赖 #

如果仅为类型层面的依赖（比如类实现某个接口），使用import type导入，避免触发实际模块加载，降低循环依赖的影响：

// B.ts
import type { IBase } from './interfaces/ABC';
import { A } from './A';

class B extends A implements IBase {
  // 类逻辑
}

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