Angular/NX项目tsconfig全局路径别名是否可继承并叠加本地配置

• TypeScript 本身的extends配置合并逻辑，就支持全局别名+子项目本地别名共存，不需要重复定义通用别名。
• 根目录通用别名（比如NX生成的libs库别名）建议统一写在根路径的tsconfig.base.json（NX默认全局配置文件）的compilerOptions.paths字段中，所有子项目默认继承该配置。
• 子项目的路径别名配置不会全量覆盖全局配置：二者是合并生效的关系，只有子项目中与全局配置重名的路径前缀，才会在当前子项目内覆盖全局规则，其余不重名的全局别名都可以正常使用。

配置示例 #

根目录 tsconfig.base.json 全局配置 #

{
  "compilerOptions": {
    "paths": {
      // 全局通用的库别名，所有子项目都可以直接用
      "@your-org/libs/*": ["libs/*"],
      "@your-org/shared/utils": ["libs/shared/utils/src/index.ts"]
    }
  }
}

子应用 apps/demo-app/tsconfig.json 本地配置 #

{
  "extends": "../../tsconfig.base.json",
  "compilerOptions": {
    "paths": {
      // 本地新增的别名，仅当前项目生效，不影响全局配置
      "@app/*": ["./src/app/*"],
      // 仅当你显式写了和全局同名的前缀时，才会覆盖当前项目下的这条规则
      "@your-org/shared/utils": ["./src/mocks/utils.ts"]
    }
  }
}

上述配置下，demo-app 项目中可以正常使用全局的@your-org/libs/*别名，也可以使用本地的@app/*别名，只有@your-org/shared/utils会用本地的mock实现，其余全局别名不受影响。

注意事项 #

如果出现全局别名不生效的问题，优先排查两个点：

• 子项目tsconfig的extends路径是否拼写正确，确实指向了根目录的全局tsconfig文件
• 子项目的paths配置中，是否不小心重写了对应的全局别名前缀

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