React与React Native 0.74.1版本兼容匹配问题咨询

关于兼容版本说明的问题 #

React Native 0.74.1官方绑定的React版本是18.2.0，这个匹配关系在RN的版本发布说明里明确存在。另外要注意：React-dom是Web端React项目的专属依赖，纯React Native项目完全不需要安装它——RN有自己的移动端渲染层实现，和React-dom没有关联。你项目里额外引入React-dom，本身就会触发peer依赖校验冲突，因为RN的依赖声明里只指定了React的版本要求，不包含React-dom。

如果是做跨端开发（比如用React Native Web）需要保留React-dom，必须保证React和React-dom的版本完全一致，且严格匹配RN官方绑定的React版本（0.74.x对应React 18.2.0），升级到18.3.1会打破这个绑定，必然触发冲突。

依赖冲突未解决（使用--legacy-peer-deps）的负面影响 #

• 运行时异常风险：RN是和特定React版本绑定测试的，版本不匹配可能导致React内部API（比如Hooks、渲染逻辑）出现兼容问题，引发组件渲染失败、状态异常、甚至APP崩溃等情况
• 依赖树维护困难：后续安装第三方RN库时，会因为peer依赖规则混乱，频繁出现新的冲突，排查难度大幅提升
• 官方特性无法正常使用：RN的新功能、修复补丁都是基于绑定的React版本开发的，版本不匹配可能导致部分官方功能失效，或者出现未知bug
• 调试成本增高：出现问题时，很难区分是代码逻辑问题还是依赖版本冲突导致的，延长排查时间

实际解决建议 #

• 纯RN项目：直接移除react-dom依赖，将react版本固定为18.2.0，重新执行npm install即可解决冲突
• 跨端项目：确保react和react-dom版本均为18.2.0，同时结合React Native Web的兼容要求调整配置

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