Angular 9.0.2项目安装MapBox GL依赖冲突问题求助
2026-7-29
问题解决：Angular 9.0.2 安装 MapBox GL 依赖冲突与 TypeScript 支持确认
TypeScript 支持说明
MapBox GL 原生支持 TypeScript，它的 npm 包内置了完整的类型定义文件，安装后直接就能在 TypeScript 代码中使用，无需额外安装类型声明包。
依赖冲突（ERESOLVE）解决方法
冲突根源是安装 mapbox-gl 时，npm 自动拉取了 @angular/animations@9.1.9，但你的项目核心依赖是 @angular/core@9.0.2，两者的 peer 依赖要求不匹配。以下是几种可行的解决思路：
方案1：忽略 peer 依赖检查强制安装
如果暂时不想升级 Angular 版本，可以用 npm 参数跳过依赖校验：
- 执行命令：
npm install --save mapbox-gl --legacy-peer-deps - 或者：
npm install --save mapbox-gl --force
注意：小版本差异（9.0.2 vs 9.1.9）下兼容性风险较低，但安装后务必测试项目运行是否正常。
方案2：升级 Angular 核心依赖到匹配版本
把项目的 Angular 核心依赖统一升级到 9.1.9，和 @angular/animations 的要求对齐：
- 执行升级命令：
npm install @angular/core@9.1.9 @angular/common@9.1.9 @angular/compiler@9.1.9 @angular/platform-browser@9.1.9 @angular/platform-browser-dynamic@9.1.9 @angular/router@9.1.9 --save - 升级完成后再安装 mapbox-gl：
npm install --save mapbox-gl
同大版本内的升级（9.x）基本没有破坏性变更，是最稳妥的解决方式。
方案3：指定 mapbox-gl 兼容版本
如果不想升级 Angular 也不想忽略依赖检查，可以找一个发布时间适配 Angular 9.0.2 的 mapbox-gl 版本安装，比如：
- 执行命令：
npm install --save mapbox-gl@1.13.0
这个版本发布于 Angular 9.x 周期内，不会触发高版本 Angular 依赖的拉取。
内容的提问来源于stack exchange，提问作者san test
相关产品推荐
相关产品推荐
