Angular 6库独立CI构建报错：无法识别@angular/compiler-cli与TypeScript版本

我之前确实折腾过Angular 6库不嵌入应用、直接在CI流水线构建的场景，给你几个针对性的排查和解决方向：

1. 确认angular.json的项目类型配置 #

这是最容易踩坑的点：你需要确保angular.json里的库项目配置是library类型，而非默认的application类型。

• 找到你的库项目节点，把projectType从"application"改成"library"
• 同时检查architect.build.builder要使用@angular-devkit/build-ng-packagr:build（这是构建库的专用builder，而非应用的@angular-devkit/build-angular:browser）

示例片段：

"your-library-name": {
  "projectType": "library",
  "root": "",
  "sourceRoot": "src",
  "architect": {
    "build": {
      "builder": "@angular-devkit/build-ng-packagr:build",
      "options": {
        "tsConfig": "tsconfig.ci.json",
        "ngPackageConfig": "ng-package.ci.json"
      }
    }
  }
}

2. 验证ng-package.ci.json的关键配置 #

确保你的CI专用ng-packagr配置文件里明确指定了TypeScript配置路径，并且入口文件路径正确：

{
  "$schema": "./node_modules/ng-packagr/ng-package.schema.json",
  "lib": {
    "entryFile": "src/public-api.ts",
    "tsConfig": "tsconfig.ci.json"
  },
  "dest": "dist/your-library-name"
}

注意所有路径要相对于CI环境下的项目根目录，避免用绝对路径或相对子目录的错误写法。

3. 锁定依赖版本并排查冲突 #

Angular 6对@angular/compiler-cli和typescript的版本兼容性要求很严格：

• Angular 6.x对应的TypeScript版本应该是~2.7.2或~2.8.0，不要用更高版本
• 在package.json里明确锁定这两个依赖的版本，避免CI环境安装到不兼容的版本：

  "devDependencies": {
    "@angular/compiler-cli": "^6.1.10",
    "typescript": "~2.7.2"
  }
  

• CI执行安装前，建议先清理缓存：rm -rf node_modules package-lock.json && npm install，避免缓存导致的版本冲突。可以用npm ls @angular/compiler-cli typescript命令检查实际安装的版本是否匹配。

4. 调整CI构建命令的参数 #

不要直接用默认的ng build，而是明确指定项目和配置文件：

ng build --project your-library-name --angular-cli-config angular.json

如果你的angular.json已经正确关联了CI专用的tsconfig和ng-packagr配置，这条命令就能正确触发库的构建。

5. 检查CI工作目录 #

确保CI脚本的执行目录是库的根目录（也就是package.json、angular.json所在的目录），如果CI在子目录执行命令，所有路径都会失效，导致无法找到依赖和配置文件。

我当时就是因为没把angular.json里的projectType改成library，一直报这个版本检测错误，调整后就正常了。

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