RN 环境搭建、版本兼容问题
可以。RN(React Native)最容易踩坑的其实不是“安装不上”,而是RN、Node、JDK、Gradle、AGP、Kotlin、Android SDK、Xcode 之间的版本组合不兼容。
如果你现在准备搭一个 RN 项目,我建议直接按“先确定 RN 版本 → 再锁定原生工具链”的方式来,不要先把 Node、Java、Android Studio 全部升级到最新版。
目前 RN 版本兼容重点
截至 2026 年 8 月,React Native 最新稳定版已经是 0.87。(React Native)
RN 0.87 有几个非常重要的变化:
| 项目 | RN 0.87 |
|---|---|
| React Native | 0.87.x |
| Node.js | ≥ 22.13.0 |
| Kotlin | ≥ 2.0 |
| Android Gradle Plugin | AGP 9 |
| compileSdk | 37 |
| Build Tools | 37 |
| Hermes | Hermes V1 |
| TypeScript API | Strict API 默认开启 |
这些是 0.87 的硬性变化,尤其是 AGP 9 + Kotlin 2.x,如果你拿以前 RN 0.7x/0.8x 的项目配置直接套,很容易出现 Gradle 构建问题。(React Native)
另外,RN 官方环境文档目前建议 Node 22.11.0+、JDK 17;不过对于 RN 0.87,Node 的实际最低要求已经提高到 22.13.0。(React Native)
如果你是 Windows + Android 开发
你可以先按这一套搭:
Node.js 22.x
JDK 17
React Native 0.87.x
Android SDK 35/37 按项目要求
Gradle 跟随 RN 0.87 模板
AGP 9.x
Kotlin 2.x
Android Studio 最新稳定版
官方目前 Windows 环境也推荐 Node LTS + JDK 17。(React Native)
环境变量
Windows 主要确认:
JAVA_HOME
ANDROID_HOME
例如:
JAVA_HOME=C:\Program Files\Microsoft\jdk-17.x.x
ANDROID_HOME=%LOCALAPPDATA%\Android\Sdk
Path 加:
%JAVA_HOME%\bin
%ANDROID_HOME%\platform-tools
%ANDROID_HOME%\emulator
然后检查:
node -v
npm -v
java -version
adb --version
RN 版本兼容最重要的一张图
你以后遇到 RN 报错,可以先按照这个关系排查:
React Native
│
├── Node.js
│
├── React
│
├── Metro
│
├── Hermes
│
└── Android
│
├── JDK
├── Gradle
├── Android Gradle Plugin
├── Kotlin
├── compileSdk
└── buildTools
不要单独升级其中某一个。
例如:
RN 0.73
↓
JDK 17
↓
AGP 8.1.x
↓
Gradle 8.x
↓
Android SDK 34
RN 0.73 开始就要求 Java 17,并升级到了 AGP 8.1.x。(React Native)
而到了:
RN 0.87
↓
Node 22.13+
↓
AGP 9
↓
Kotlin 2+
↓
compileSdk 37
已经是另外一套工具链了。(React Native)
如果你是“已有 RN 项目”
这个反而更重要。
不要直接执行:
npm update
或者:
npm install react-native@latest
尤其是老项目。
应该先看:
npx react-native --version
然后:
node -v
java -version
再看:
package.json
android/build.gradle
android/settings.gradle
android/gradle/wrapper/gradle-wrapper.properties
android/gradle.properties
重点确认:
react-native
react
@react-native/*
Node
Gradle
AGP
Kotlin
compileSdk
targetSdk
minSdk
JDK
如果你现在刚开始学 RN
我反而建议你不要从 RN 0.87 开始折腾复杂原生环境,除非你明确需要最新 RN。
如果目标是:
Vue 前端 → 开始学习 React Native → 做 Android App
那么我可以直接给你整理一套:
Windows + RN + Android Studio + VS Code + Node + JDK 的完整安装方案
包括:
-
Node 应该装哪个版本
-
JDK 装 17 还是 21
-
Android Studio 装哪个版本
-
SDK 装哪些
-
环境变量怎么配置
-
RN 项目怎么创建
-
Gradle/AGP/Kotlin 怎么对应
-
npm install报错怎么处理 -
npx react-native run-android报错怎么处理 -
RN 0.7x / 0.8x / 0.87 版本兼容表
你如果是Windows 环境,我可以直接按照你电脑的情况给你一套“从 0 安装到第一个 RN App 跑起来”的步骤。
更多推荐


所有评论(0)