Nx Framework非根路径导入编译时触发TS2307错误咨询

VSCode可正常解析类型，说明TS路径规则的匹配逻辑本身没有语义错误，编译阶段报错基本是编译进程未正确读取路径映射、或Nx默认导出拦截导致，按以下顺序排查即可：

• 修正tsconfig配置语法与继承关系
  你贴出的路径配置存在语法问题：别名键名左侧缺失双引号，修正后根目录tsconfig.base.json内的paths配置应为：

  {
    "compilerOptions": {
      "paths": {
        "@backend/kernel": ["libs/kernel/src/index.ts"],
        "@backend/kernel/*": ["libs/kernel/src/*"]
      }
    }
  }
  

  同时确认所有子应用、子库的tsconfig.json都通过extends字段继承了根目录的tsconfig.base.json，不要在子项目配置中重写paths字段覆盖全局规则。
• 校验TS编译本身的路径解析能力
  在项目根目录执行以下命令，跳过构建工具逻辑直接用TS官方编译器校验路径解析：

  npx tsc -p tsconfig.base.json --noEmit
  

  • 如果该命令执行不报错：问题出在构建工具配置上，检查你使用的构建器：
    • 基于Webpack的构建：确认配置了tsconfig-paths-webpack-plugin，且插件的configFile参数指向根目录tsconfig.base.json，没有通过include/exclude规则过滤@backend/*别名
    • 基于Vite的构建：升级vite-tsconfig-paths插件到最新版本，旧版本对3级以上的深层路径通配符匹配存在已知bug
    • 基于Rollup/ESBuild的构建：确认开启了tsconfig路径解析插件，没有手动配置alias规则覆盖tsconfig的映射
  • 如果该命令仍然报TS2307：检查libs/kernel/src/目录下对应的深层路径文件是否真实存在，文件名大小写是否和导入语句完全一致（TS在大小写敏感的文件系统下会因为文件名大小写不匹配报找不到模块）
• 调整Nx库的导出限制
  Nx默认对标记为buildable的库做导出校验，仅允许从index.ts入口导入，要支持深层导入需要修改对应kernel库的project.json配置：

  {
    "targets": {
      "build": {
        "executor": "@nrwl/js:tsc",
        "options": {
          "updateBuildableProjectDepsInPackageJson": false
        }
      }
    }
  }
  

  如果该库仅作为仓库内部依赖不需要发布，可以直接删除库的build目标，Nx会跳过导出校验，直接走TS路径映射解析。
• 清理缓存后重试
  Nx、TS、构建工具都会缓存路径解析结果，改完配置后执行以下命令清理所有缓存：

  npx nx reset
  rm -rf node_modules/.cache
  

  VSCode中按Ctrl+Shift+P（Mac为Cmd+Shift+P）调出命令面板，执行TypeScript: Restart TS Server重启TS服务，避免旧缓存导致的异常。

修复验证标准：根目录执行npx tsc --noEmit无TS2307报错，执行对应项目的nx build命令编译通过即为修复完成。

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