You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

安装npm包google-maps-react时报错,寻求可行解决方法

安装google-maps-react报错解决方案

该类报错核心原因是google-maps-react包长期未维护,仅适配React 16.x及更早版本,如果你的项目使用React 17/18版本,就会触发peer依赖冲突。以下是三种可行解决方式:

  • 方法1:强制安装(适合临时验证场景)
    在安装命令中添加--legacy-peer-deps参数,忽略npm 7+版本的peer依赖校验规则:

    npm install google-maps-react --legacy-peer-deps
    
  • 方法2:替换为官方维护包(推荐生产环境使用)
    google官方目前维护了适配新React版本的地图SDK,替换后不会出现依赖冲突,功能覆盖度更高:

    1. 卸载未安装完成的google-maps-react
    npm uninstall google-maps-react
    
    1. 安装官方适配包
    npm install @googlemaps/react-wrapper
    
  • 方法3:降级React版本(仅当项目强制依赖google-maps-react时使用)
    将项目React版本降至google-maps-react支持的16.x版本:

    npm install react@16.x react-dom@16.x
    

    降级完成后正常执行安装命令即可:

    npm install google-maps-react
    

内容的提问来源于stack exchange,提问作者Nav

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.26 03:39:01