遵循Tailwind指南创建React项目失败求助

问题原因 #

React 19正式发布后，create-react-app的默认初始化模板尚未同步更新配套测试库版本。你当前安装的react@19.0.0与模板自带的@testing-library/react@13.4.0要求的peer依赖react@^18.0.0不兼容，触发npm依赖树解析失败。

可行解决办法 #

方案1：降级React到18.x稳定版（推荐用于学校作业，兼容性最高） #

• 卸载现有React及ReactDOM：

  npm uninstall react react-dom
  

• 安装18.x最新稳定版本：

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

• 验证依赖状态：

  npm ls react @testing-library/react
  

  确认无冲突后即可正常使用项目，后续按Tailwind指南集成即可。

方案2：升级测试库到兼容React 19的版本 #

@testing-library/react v14及以上版本已支持React 19，执行以下命令更新测试相关依赖：

npm install @testing-library/react@latest @testing-library/jest-dom@latest @testing-library/user-event@latest

更新完成后重新运行项目，依赖冲突会自动解决。

方案3：临时跳过peer依赖检查（应急方案，不推荐长期使用） #

初始化项目时直接添加--legacy-peer-deps参数绕过冲突：

npx create-react-app programmeren6frontend2024 --use-npm --legacy-peer-deps

若已创建项目，可在项目根目录执行：

npm install --legacy-peer-deps

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