如何修复Airframe React JavaScript项目模板的依赖冲突问题

各报错对应的原因与修复方法 #

1. 首次安装的ERESOLVE依赖树冲突报错 #

这个是npm 7及以上版本的默认严格peer依赖校验导致的。这个模板是2019年发布的老项目，依赖版本都是按当时的兼容逻辑写的：项目声明的eslint版本为^6.1.0，但引入的eslint-config-airbnb@17.1.1仅支持eslint 4.x、5.x版本，版本范围不匹配就会触发校验拦截。
不用手动改eslint版本号，安装时带上兼容老项目依赖逻辑的参数即可：

npm install --legacy-peer-deps

如果装完启动碰到eslint规则兼容报错，把eslint-config-airbnb升到支持eslint 6的18.x版本就行，不会影响项目业务代码运行。

2. spawn git ENOENT报错 #

这个报错没有其他深层原因，就是本地系统没装Git，npm安装部分依赖时需要调用git命令拉取资源，找不到对应可执行程序就会抛错。安装Git后把Git的bin目录加入系统PATH环境变量，重启终端就能解决。

3. faker.js仓库拉取权限报错（code 128） #

为什么安装会访问faker.js的Git仓库？

项目依赖的faker@^4.1.0包的原作者在2021年主动下架了npm上的所有正式发布版本，还在后续提交里加入了恶意逻辑，公共npm源已经没有可用的4.x版本faker安装包。npm解析不到对应版本的正式包时，会自动回退尝试拉取GitHub上的源码仓库直接安装，默认拉取用SSH协议，本地没配置GitHub SSH公钥的话就会报公钥权限拒绝的错误。

修复方法

不需要配置GitHub SSH密钥，直接把faker依赖替换为社区维护的可用镜像版本即可：

• 打开项目根目录的package.json，找到dependencies下的"faker": "^4.1.0"字段，替换为：

"faker": "npm:@faker-js/faker@^4.1.0",

• 删除项目目录下之前安装生成的node_modules文件夹和package-lock.json文件
• 重新执行安装命令：

npm install --legacy-peer-deps

额外注意：如果安装时碰到node-sass二进制包下载失败的问题，是因为node-sass@4.x不支持Node.js 16及以上版本，把本地Node.js切换到14.x长期支持版再重新安装即可，这个版本也是这类2020年之前发布的老React项目适配度最高的Node版本。

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