React Native项目npm依赖冲突求助：install失败及后续兼容疑问

一、先搞定React和React-Dom版本不匹配的问题 #

react和react-dom版本必须严格对齐，这是硬要求，不解决后续肯定出问题：

• 方案1：把react-dom降到17.0.2
  直接执行命令：

  npm install react-dom@17.0.2 --save-exact
  

  适合不想升级React版本的场景，确保两个包版本完全一致。
• 方案2：把React升到18.2.0
  先确认你的React Native版本是0.68及以上（只有这个版本及以后支持React 18），如果符合要求，执行：

  npm install react@18.2.0 --save-exact
  

  React 18对17兼容性很好，大部分项目不用改代码就能过渡，少数依赖旧hooks写法的地方可能需要微调。

二、修复ESLint相关插件的Peer依赖冲突 #

针对@typescript-eslint/eslint-plugin、@typescript-eslint/parser、eslint-plugin-react-native和eslint@8.12.0的不兼容问题，按步骤来：

1. 先查每个插件的Peer依赖要求
   执行下面的命令，看每个插件需要的ESLint版本范围：

npm show @typescript-eslint/eslint-plugin peerDependencies
npm show @typescript-eslint/parser peerDependencies
npm show eslint-plugin-react-native peerDependencies

比如@typescript-eslint v5.x一般支持eslint@^7.0.0 || ^8.0.0，如果你的插件版本太老，可能只支持到eslint@7.x，这时候就得升级插件。
2. 针对性升级/降级插件或ESLint

• 如果插件版本低，直接升级到兼容eslint@8.12.0的版本：

  npm install @typescript-eslint/eslint-plugin@latest @typescript-eslint/parser@latest eslint-plugin-react-native@latest --save-dev
  

  升级完跑一下npm ls eslint看看还有没有冲突。
• 如果升级插件还是有问题，就微调ESLint版本到插件支持的范围（比如插件要求eslint@^8.0.0但不支持8.12.0，就降到8.10.0这种兼容版本）：

  npm install eslint@8.10.0 --save-exact --save-dev
  

3. 用npm Overrides强制统一版本（备选）
   要是必须保留现有库版本，就在package.json里加个overrides字段，强制让冲突插件用当前的ESLint版本：

"overrides": {
  "@typescript-eslint/eslint-plugin": {
    "eslint": "$eslint"
  },
  "@typescript-eslint/parser": {
    "eslint": "$eslint"
  },
  "eslint-plugin-react-native": {
    "eslint": "$eslint"
  }
}

这个方法能强制对齐版本，但要记得测试ESLint功能正常才行。

三、关于--legacy-peer-deps的风险规避 #

用--legacy-peer-deps确实会跳过peer依赖检查，后续可能出现运行时错误（比如插件调用了ESLint没有的API，或者React组件用了不兼容的DOM方法）。如果不得不临时用这个命令安装，装完一定要做这些验证：

• 跑ESLint检查：npx eslint .，确保没报错
• 启动项目：npx react-native start + npx react-native run-android/ios，检查运行时有没有问题
• 跑单元测试：确保所有用例都能过

四、最后验证依赖状态 #

处理完所有冲突后，执行npm ls检查有没有残留的依赖警告，确保所有peer依赖都满足要求。

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