使用create-react-app创建新React应用时出现依赖冲突错误求助

错误原因 #

项目安装了React 19.0.0，但@testing-library/react@13.4.0的peer依赖要求React版本为^18.0.0，npm的依赖解析机制因版本不兼容抛出ERESOLVE错误。

解决方案 #

• 使用npm兼容参数跳过peer依赖检查
  在安装命令后添加--legacy-peer-deps（优先推荐）或--force参数：

  npm install --legacy-peer-deps
  # 或
  npm install --force
  

  --legacy-peer-deps采用npm旧版解析逻辑忽略冲突，--force强制安装但可能存在兼容性隐患。

• 降级React到18.x版本
  修改项目根目录package.json中react和react-dom的版本：

  {
    "dependencies": {
      "react": "^18.0.0",
      "react-dom": "^18.0.0"
    }
  }
  

  执行重新安装命令：

  npm install
  

  此方法从根源解决版本不兼容问题。

• 升级测试库到兼容React 19的版本
  尝试安装@testing-library/react的最新版本（若已适配React 19）：

  npm install @testing-library/react@latest
  

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