Angular Monorepo编译错误：TS2451重复声明ngDevMode

这个错误我在搭建Angular monorepo时也碰到过，本质原因是你的lib包和主app重复引入了Angular核心模块里的ngDevMode变量——这个变量是Angular内部用来标记开发模式的，当两个项目同时包含它的定义时，TypeScript就会抛出重复声明的错误。下面是具体的解决步骤：

1. 确保Lib包按Angular Library规范构建 #

首先要避免把Angular核心代码打包进lib的输出：

• 打开lib的package.json，把所有@angular/*相关依赖移到peerDependencies字段，而非dependencies。示例：

  "peerDependencies": {
    "@angular/core": "^16.0.0",
    "@angular/common": "^16.0.0"
  },
  "dependencies": {
    // 只放lib自身的业务依赖，不要包含Angular核心包
  }
  

• 确认lib的angular.json构建配置使用library专用的builder：

  "architect": {
    "build": {
      "builder": "@angular-devkit/build-angular:ng-packagr",
      "options": {
        "project": "packages/lib/ng-package.json"
      }
    }
  }
  

2. 正确配置主App的路径映射 #

在主app的tsconfig.json中，确保路径映射指向lib的构建输出目录，同时规避类型检查冲突：

• 添加paths配置（注意要和lib的package.json中name字段一致）：

  "compilerOptions": {
    // 其他配置...
    "paths": {
      "@your-monorepo/lib": ["../lib/dist/lib"]
    },
    // 可选：跳过第三方库的类型检查，避免重复类型冲突
    "skipLibCheck": true
  }
  

3. 清理缓存并重新构建 #

缓存残留很容易引发奇怪的编译错误，按以下顺序操作：

• 清理Angular缓存：ng clean
• 先构建lib包：ng build lib
• 再构建主app：ng build app

4. 确保Angular版本完全一致 #

检查app和lib的package.json中所有@angular/*包的版本号必须完全相同，哪怕是小版本差异都可能导致类型定义冲突，触发ngDevMode重复声明问题。

验证方法 #

构建完成后，查看packages/lib/dist/lib/package.json，确认@angular/core等核心包只出现在peerDependencies中，没有被打包进lib的输出文件。此时主app导入lib时会使用自身的Angular依赖，不会出现重复定义问题。

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