迁移至NX项目后tsconfig paths在部分组件文件中失效

先改个致命拼写错误！ #

你贴的tsconfig.base.json里有个低级错误：compilterOptions应该是compilerOptions（少了个字母r），这个错误会导致整个路径配置不生效，部分文件可能因为IDE的兼容逻辑临时识别，但大部分组件会失效。修正后的正确配置：

{
   "compileOnSave": false,
   "compilerOptions": {
       "baseUrl": ".",
       "downlevelIteration": true,
       "outDir": "./dist/out-tsc",
       "sourceMap": true,
       "paths": {
           "@root/*": ["apps/application/src/app/*"],
           "shared": ["libs/shared/src/index.ts"]
       }
    }
}

检查组件目录的tsconfig继承 #

• 找到识别不了路径的组件（比如feature.component.ts）所在目录的tsconfig.json，比如apps/application/src/app/feature/tsconfig.json，或者全局的apps/application/tsconfig.app.json。
• 确保它的extends字段正确指向根目录的tsconfig.base.json，比如如果是子目录的配置，应该写成"extends": "../../../../tsconfig.base.json"（根据实际目录层级调整）。
• 别让子目录的tsconfig重新定义paths或者baseUrl，否则会覆盖根配置。

清缓存重启TS服务 #

• IDE的TypeScript服务经常抽风，VS Code里可以按Ctrl+Shift+P（Windows）/Cmd+Shift+P（Mac），输入TypeScript: Restart TS Server，重启后再打开组件文件试试。
• 彻底清项目缓存：删掉根目录的.angular/cache、node_modules/.cache文件夹，然后跑一遍nx build application重新编译。

额外验证步骤 #

• 执行nx lint application，让NX的lint工具检查路径配置是否有其他问题。
• 确认shared库的index.ts确实导出了你要引用的内容，不然即使路径识别了，也会出现导入错误。

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