首次创建React应用遇eslint版本不兼容问题,求解决方案
解决Create React App eslint版本冲突问题
报错核心原因:Create React App 提供的
react-scripts依赖要求 eslint 版本为^7.11.0,但检测到用户全局目录/Users/karinapichardo/node_modules/eslint下存在更高版本的 eslint v8.2.0,导致启动时依赖校验失败。
场景1:无需保留全局eslint v8版本(推荐方案)
- 第一步:卸载全局安装的高版本eslint
npm uninstall -g eslint # 若使用yarn全局安装则执行 yarn global remove eslint
执行完成后运行 eslint -v,若提示命令不存在即为卸载成功。
- 第二步:清理当前项目的冗余依赖缓存
进入你的React项目根目录,删除node_modules文件夹、package-lock.json文件(若使用yarn则删除yarn.lock文件),可手动删除也可执行以下命令:
# Mac/Linux系统执行 rm -rf node_modules package-lock.json
- 第三步:重新安装项目依赖
npm install
此时react-scripts会自动安装匹配要求的eslint v7.11.0版本到项目本地依赖,无需手动额外安装。
- 第四步:验证启动
执行npm start即可正常启动项目,项目使用的eslint版本为要求的v7.x版本。
场景2:需要保留全局eslint v8版本
如果你全局有其他项目依赖eslint v8版本不想卸载,可以直接在当前项目本地强制安装指定版本的eslint:
- 进入项目根目录执行命令:
npm install eslint@7.11.0 --save-dev
- 安装完成后删除
node_modules/.cache文件夹,再执行npm start即可正常启动。 - 若仍有校验报错,可以在项目根目录新建
.env文件,添加以下内容跳过版本预校验:
SKIP_PREFLIGHT_CHECK=true
该配置仅对当前项目生效,不会影响全局其他项目的eslint使用。
验证版本是否符合要求
在项目根目录执行命令:
npx eslint -v
若输出7.11.0即为配置成功,npx会优先调用项目本地安装的eslint版本。
内容的提问来源于stack exchange,提问作者karinapichardo
相关产品推荐
相关产品推荐

