在pnpm+nx monorepo中无法从@angular/compiler-cli导入readConfiguration

一、readConfiguration未暴露在公共API的原因 #

• readConfiguration是Angular编译器的内部工具函数，并非为外部开发者设计的公共API。Angular团队会隐藏这类内部实现细节，目的是避免外部依赖限制后续版本的迭代——内部逻辑调整时，未暴露的API不会影响公共使用场景的兼容性。
• 该函数所在的src/perform_compile.ts属于编译器的内部实现文件，Angular包发布时只会将经过设计、测试的稳定API导出到index.d.ts（公共类型入口），内部文件的内容不会被纳入公共导出列表。

二、导入错误的解决办法 #

方法1：使用官方公共替代API #

如果你的需求是读取Angular项目配置，推荐使用@angular-devkit/build-angular包中的readWorkspaceConfiguration，这是官方专门为外部工具提供的公共API，类型定义完整，且版本兼容性有保障。

方法2：直接导入内部文件（不推荐） #

若必须使用readConfiguration，可以绕过公共入口直接导入内部实现文件，但这种方式依赖未公开的内部API，后续Angular版本更新可能导致代码失效：

import { readConfiguration } from '@angular/compiler-cli/src/perform_compile';

同时需要在tsconfig.json中调整配置，允许导入非公共入口的模块：

{
  "compilerOptions": {
    "skipLibCheck": true,
    "allowSyntheticDefaultImports": true
  }
}

注：pnpm的包布局并非问题根源——即使换用npm/yarn，同样会遇到类型报错，只是pnpm更严格的包隔离让这个问题更早显现。

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