CRA集成React Leaflet运行官方示例出现编译失败问题求助
这个报错的核心原因是你使用的react-scripts版本不支持识别ES2020新增的空值合并运算符(??)。当前最新的react-leaflet v4+版本源码中大量使用了包括空值合并运算符在内的ES2020新语法,而低于5.0版本的react-scripts默认babel配置只会转译项目src目录下的代码,不会转译node_modules中的@react-leaflet、react-leaflet相关依赖,因此解析到未转译的??符号时就会抛出语法解析失败的错误。
你可以根据自己的项目场景选择以下任意一种方案解决:
方案1:降级react-leaflet到兼容版本(无需修改配置,最便捷)
react-leaflet v3.x版本未使用ES2020新语法,可直接适配低版本react-scripts,执行以下命令安装对应版本即可:npm install react-leaflet@3.2.5 leaflet@1.7.1安装完成后重新启动项目即可正常运行。
方案2:升级react-scripts到5.x版本
react-scripts 5.0及以上版本默认支持ES2020语法解析,可直接识别空值合并运算符,执行以下命令升级:npm install react-scripts@latest升级完成后删除项目根目录的
node_modules文件夹和package-lock.json(yarn用户删除yarn.lock),重新执行npm install安装依赖后启动项目即可。注意:如果你的项目中存在大量旧的第三方依赖,需要提前验证依赖和react-scripts 5.x的兼容性,避免出现其他兼容问题。
方案3:自定义转译配置适配新版react-leaflet(适合不能降级依赖也不能升级react-scripts的场景)
你可以通过craco工具覆写create-react-app的默认配置,将react-leaflet相关依赖纳入babel转译范围:- 首先安装所需依赖:
npm install @craco/craco @babel/plugin-proposal-nullish-coalescing-operator --save-dev- 项目根目录新建
craco.config.js,写入以下配置:
module.exports = { babel: { plugins: ["@babel/plugin-proposal-nullish-coalescing-operator"] }, webpack: { configure: (config) => { const babelLoader = config.module.rules.find(rule => rule.oneOf) .oneOf.find(rule => rule.loader && rule.loader.includes('babel-loader')) babelLoader.include = [ babelLoader.include, /node_modules\/@react-leaflet/, /node_modules\/react-leaflet/ ] return config } } }- 修改
package.json中的scripts配置,将所有react-scripts替换为craco:
"scripts": { "start": "craco start", "build": "craco build", "test": "craco test", "eject": "react-scripts eject" }- 重新启动项目即可。
内容的提问来源于stack exchange,提问作者Victor Seara

