跨工作空间导入使用及TS6202循环引用错误解决

你碰到的Error TS6202: Project references may not form a circular graph，本质是utils和api两个包在tsconfig.json里互相配置了项目引用，形成了循环依赖链，TypeScript的项目引用机制明确禁止这种情况。下面给你几个可行的解决思路：

1. 拆分公共依赖到新包（最推荐的长期方案） #

把两个包互相依赖的那部分代码抽出来，单独建一个公共包，彻底打破循环：

• 在packages目录下新建shared（或common）包，配置独立的tsconfig.json（不需要引用任何其他包）
• 把utils中需要调用的api功能、api中需要调用的utils功能，全部迁移到shared包里
• 修改utils/tsconfig.json的references：移除../api/src，添加../shared/src
• 修改api/tsconfig.json的references：移除../utils/src，添加../shared/src
• 之后utils和api各自从shared包导入需要的代码即可

2. 改用动态导入规避编译时依赖 #

如果不想新建包，可以把其中一方的静态依赖改成运行时动态导入，绕开编译阶段的项目引用检查：

• 比如先删掉utils/tsconfig.json里的../api/src引用
• 在utils的代码中，把原来静态导入api的逻辑改成动态导入：

  // 替换原来的静态导入：import { someApiFunc } from '@your-project/api';
  async function useApiFeature() {
    const { someApiFunc } = await import('@your-project/api');
    return someApiFunc();
  }
  

• 这种方式下，编译时utils不再依赖api的项目引用，只有运行时才会加载api的代码，自然打破了循环

3. 调整职责边界，消除不必要的互相依赖 #

先仔细梳理代码逻辑，看看是不是真的需要互相依赖：

• 检查utils里调用的api功能，是不是原本就不该放在api包？比如如果是纯数据处理逻辑，应该移到utils里
• 检查api里调用的utils功能，是不是可以在api内部实现？（临时救急可以这么做，但长期不推荐，会导致代码冗余）
• 重新划分两个包的职责：比如让utils只做纯工具类逻辑（和业务、接口无关），api只做接口请求和业务逻辑，从根源上避免互相依赖

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