如何解读并解决npm依赖冲突问题

错误日志逐段解析 #

你的错误核心是ERESOLVE could not resolve，说明npm无法找到同时满足所有包版本要求的依赖组合，具体冲突链如下：

1. 冲突起点：npm在解析@angular-devkit/build-ng-packagr@0.8.0的依赖时触发问题。
2. 现有依赖：当前项目已安装tsickle@0.32.1，它是@angular/compiler-cli@6.1.10的直接依赖，而@angular/compiler-cli是你根项目的开发依赖。
3. peer依赖要求：@angular-devkit/build-ng-packagr@0.8.0声明了peer依赖，要求项目中必须安装ng-packagr@^2.2.0 || ^3.0.0 || ^4.0.0版本。
4. 冲突点：为满足上述peer依赖，npm会选择ng-packagr@4.7.1（属于4.x兼容范围），但这个版本的ng-packagr又声明了peer依赖tsickle@>=0.34.0——这和你当前已有的tsickle@0.32.1版本不兼容，导致依赖链断裂，npm无法完成安装。

包依赖 vs Peer依赖 #

• 包依赖：是某个包自身运行必需的依赖，npm会自动将其安装到对应包的node_modules目录（或根目录如果版本兼容）。比如@angular/compiler-cli@6.1.10依赖tsickle@^0.32.1，这是支撑它编译功能的内部依赖。
• Peer依赖：是包作者要求用户项目中预先安装的特定版本依赖，目的是避免重复安装核心包、保证版本兼容。Peer依赖不会被npm自动安装，需要用户手动管理。比如@angular-devkit/build-ng-packagr要求你自己安装ng-packagr，ng-packagr要求你安装符合版本的tsickle。

可以通过以下npm命令直接查询，无需依赖外部网站：

• 查询包的直接依赖：npm show <包名>[@版本号] dependencies
  示例：npm show @angular-devkit/build-ng-packagr@0.8.0 dependencies
• 查询包的Peer依赖：npm show <包名>[@版本号] peerDependencies
  示例：npm show ng-packagr@4.7.1 peerDependencies
• 查询包的所有可用版本：npm show <包名> versions
  示例：npm show tsickle versions
• 如果已安装部分依赖，还可以用npm explain <包名>查看该包的完整依赖链，但安装失败时该命令可能无法使用。

你的项目基于Angular 6，@angular/compiler-cli@6.x绑定的tsickle@0.32.1无法满足ng-packagr@4.x的peer依赖要求。可以尝试两种方向：

1. 降低@angular-devkit/build-ng-packagr的版本，找到一个不要求ng-packagr@4.x的版本（比如匹配Angular 6的旧版本）；
2. 升级Angular核心包到支持更高版本tsickle的版本（比如Angular 7+）；
3. 临时使用npm install --legacy-peer-deps跳过peer依赖检查，但可能导致运行时兼容性问题，不推荐长期使用。

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