迁移Angular库至NX工作区：次级入口无法导入主入口问题排查

问题重现 #

将标准Angular库迁移至NX工作区后，创建了主入口@my-corp/@my-lib，以及次级入口@my-corp/@my-lib/some-entry、@my-corp/@my-lib/some-other-entry。其中次级入口@my-corp/@my-lib/some-other-entry无法导入主入口，报错：Cannot find module '@my-corp/@my-lib' or its corresponding type declarations.。根目录tsconfig.base.json已配置路径映射，且工作区演示应用可正常导入主入口和次级入口。

可能的遗漏配置项： #

1. 次级入口的tsconfig未继承根配置 #

每个次级入口目录（如libs/my-lib/some-other-entry）下的tsconfig.json必须继承根目录的tsconfig.base.json，否则无法识别主入口的路径映射。示例配置：

{
  "extends": "../../../../tsconfig.base.json",
  "compilerOptions": {
    "outDir": "../../../../dist/out-tsc",
    "rootDir": "./src",
    "types": []
  },
  "include": ["src/**/*.ts"],
  "exclude": ["src/test.ts", "src/**/*.spec.ts"]
}

2. NX项目依赖关系未配置 #

在次级入口对应的project.json（如libs/my-lib/some-other-entry/project.json）中，需将主入口库声明为构建依赖，确保NX能正确解析依赖链：

{
  "targets": {
    "build": {
      "executor": "@nx/angular:package",
      "options": {
        "tsConfig": "libs/my-lib/some-other-entry/tsconfig.lib.json",
        "project": "libs/my-lib/some-other-entry/ng-package.json",
        // 添加主入口库作为依赖
        "dependencies": ["my-lib"]
      }
    }
  }
}

或者在根目录nx.json的implicitDependencies中添加隐式依赖映射：

{
  "implicitDependencies": {
    "my-lib-some-other-entry": ["my-lib"]
  }
}

3. 次级入口的package.json缺失主入口依赖 #

若次级入口目录下存在单独的package.json，需添加对主入口的依赖声明：

{
  "name": "@my-corp/@my-lib/some-other-entry",
  "version": "0.0.1",
  "dependencies": {
    "@my-corp/@my-lib": "*"
  }
}

4. 验证主入口类型声明生成 #

确保主入口的public-api.ts导出内容无语法错误，且已生成正确的类型声明文件。可尝试重新构建主入口库：

nx build my-lib

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