Angular 12+类库peerDependencies如何配置以兼容高版本应用？

自Angular v12起，类库允许采用低于使用它的应用的Angular版本，但应用版本必须不低于类库版本。如果将peerDependencies设置为"@angular/core": "^12.0.0"，用户使用高于12的版本安装时会触发npm依赖解析错误：

npm ERR! ERESOLVE unable to resolve dependency tree  
...  
npm ERR! Fix the upstream dependency conflict, or retry  
npm ERR! this command with --force, or --legacy-peer-deps  
npm ERR! to accept an incorrect (and potentially broken) dependency resolution.

针对这种兼容场景，有以下几种正确的配置方式：

• 使用最低版本起的开放范围：将peer依赖设置为">=12.0.0"，明确允许应用使用12.0.0及以上的所有Angular版本，完全符合Angular的兼容规则，不会触发版本冲突报错。
• 枚举兼容的大版本：如果你只测试过特定的几个大版本（比如12、13、14），可以用"^12.0.0 || ^13.0.0 || ^14.0.0"这种方式，既保证兼容已知可用的版本，又避免未测试的高版本带来潜在问题。

补充说明 #

• ^12.0.0引发报错的原因：npm的^范围对于主版本≥1的包，仅匹配同主版本内的更新（即12.x.x），不包含13及以上的大版本，因此和用户应用的高版本Angular产生了peer依赖冲突。
• 对于npm 7+版本，可配合peerDependenciesMeta明确依赖要求：

{
  "peerDependencies": {
    "@angular/core": ">=12.0.0"
  },
  "peerDependenciesMeta": {
    "@angular/core": {
      "optional": false
    }
  }
}

这里optional: false表示应用必须安装符合版本要求的Angular核心包，符合Angular类库的依赖规范。

另外，类库发布前建议用目标版本范围内的Angular应用做兼容性测试，确保类库代码适配不同版本的Angular API（比如部分API在大版本更新中可能有废弃或变更），避免出现版本兼容但功能异常的情况。

内容的提问来源于stack exchange，提问作者Get Off My Lawn