使用create-react-app创建React新项目时的依赖解析错误问题

问题原因 #

npx create-react-app 当前默认生成 React 19 版本的项目，但 @testing-library/react@13.4.0 仅支持 React 18，版本不匹配导致依赖树解析失败，抛出 ERESOLVE 错误。

解决方案 #

方案1：升级测试库兼容React 19

@testing-library/react 14.x及以上版本已适配React 19，执行以下命令升级：

npm install @testing-library/react@latest --save-dev

升级后建议同步更新@testing-library/jest-dom、@testing-library/user-event等相关测试依赖到最新版，避免后续出现其他兼容问题。

方案2：临时绕过依赖检查（不推荐）

若暂时不想升级测试库，可通过参数跳过peer依赖校验：

npm install --legacy-peer-deps

⚠️ 注意：此方法仅临时解决安装问题，可能引发运行时未知bug，不建议生产环境使用。

方案3：退回到React 18版本

若不需要React 19特性，可直接创建React 18项目：

npx create-react-app my-app --template cra-template@5.0.1

或修改现有项目的package.json，指定React版本为18.x：

"react": "^18.2.0",
"react-dom": "^18.2.0"

删除node_modules和package-lock.json后，重新执行：

npm install

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