React项目安装@testing-library/react遇依赖树解析错误求助

问题原因 #

你的项目使用React 17，而最新版本的@testing-library/react（v13+）要求React 18及以上版本，npm在解析依赖树时发现版本冲突，因此抛出错误。

解决方案 #

1. 安装兼容React 17的测试库版本 #

直接指定适配React 17的@testing-library/react版本（v12.x系列），执行以下命令：

npm install --save-dev @testing-library/react@^12.1.5

这个版本完全兼容React 17，无需修改现有项目代码。

2. 升级React到18（推荐长期维护的项目） #

如果你的项目可以升级到React 18，先更新React相关依赖：

npm install react@^18.2.0 react-dom@^18.2.0 @types/react@^18.2.0 @types/react-dom@^18.2.0

升级完成后，再安装最新版的测试库：

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

注意：升级React 18后，需要修改项目入口文件的渲染逻辑，比如将ReactDOM.render替换为createRoot。

3. 临时跳过依赖检查（不推荐） #

如果只是临时需要安装，可使用--legacy-peer-deps参数强制跳过peer依赖检查，但可能引发潜在的兼容性问题：

npm install --save-dev @testing-library/react --legacy-peer-deps

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