如何选择@angular/common版本以解决项目依赖冲突问题

核心冲突点：

• 根项目依赖@angular/common@^16.0.0
• 安装的ngrx-store-localstorage@16.1.0要求peer依赖@angular/common@^17.0.4

流水线报错详情：

npm ERR! code ERESOLVE
npm ERR! ERESOLVE unable to resolve dependency tree
npm ERR! 
npm ERR! While resolving: dim-angular@0.0.
npm ERR! Found: @angular/common@16.2.12
npm ERR! node_modules/@angular/common
npm ERR!   @angular/common@"^16.0.0" from the root project
npm ERR! 
npm ERR! Could not resolve dependency:
npm ERR! peer @angular/common@"^17.0.4" from ngrx-store-localstorage@16.1.0
npm ERR! node_modules/ngrx-store-localstorage
npm ERR!   ngrx-store-localstorage@"^16.0.0" from the root project
npm ERR! 
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.
npm ERR! 
npm ERR! See /root/.npm/eresolve-report.txt for a full report.

解决方案 #

方案1：降级ngrx-store-localstorage到兼容Angular 16的版本

ngrx-store-localstorage 16.x系列原本适配Angular 16，但16.1.0版本意外提升了peer依赖要求。修改package.json中的依赖声明，锁定到16.0.x的稳定版本：

"ngrx-store-localstorage": "^16.0.0"

执行npm install后，npm会自动安装16.0.x中最高的兼容版本，解决版本冲突。

方案2：升级Angular项目到17.x版本

如果项目允许升级，将所有Angular核心依赖（包括@angular/common）升级到^17.0.4及以上版本，满足ngrx-store-localstorage@16.1.0的peer依赖要求。使用Angular CLI命令升级：

ng update @angular/core@17 @angular/cli@17

注意：升级前备份代码，部分API存在破坏性变更，需要适配。

方案3：临时绕过依赖检查（不推荐）

若需快速跳过冲突（可能引发运行时兼容性问题），在流水线的npm install命令后添加参数：

npm install --legacy-peer-deps

或使用--force强制安装，此方案仅作为临时应急手段，可能导致依赖树不稳定。

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