React Native搭建环境完整示例：涵盖Android Studio设置

从零开始搭建 React Native 开发环境：Android 篇实战全指南

你有没有经历过这样的场景？
兴致勃勃想用 React Native 写个 App，结果刚敲下 npx react-native init ，命令行就报出一连串红字错误：“SDK not found”、“Gradle sync failed”、“Could not start daemon”……折腾半天，项目没跑起来，心态先崩了。

别急，这太常见了。 React Native 的开发环境配置，尤其是 Android 部分，是绝大多数新手的第一道“劝退关” 。它不像纯前端那样开箱即用，而是横跨 JavaScript、Java、Android 原生工具链的复杂系统工程。

今天我们就来一次讲透——如何在 Windows 或 macOS 上，从零搭建一个稳定可用的 React Native 开发环境，重点攻克 Android Studio 设置、SDK 路径、JDK 版本兼容性、环境变量配置 等高频痛点，让你少走弯路，直接上车开发。

为什么 React Native 环境这么“难搞”？

React Native 并不是运行在 WebView 里的混合应用框架，它的核心理念是“用 JS 写代码，生成原生 UI”。这意味着：

• 你的 JavaScript 代码通过 Metro 打包器 编译
• 最终要交给 Android 的 Java/Kotlin 层去渲染真正的 Button、ScrollView
• 构建过程依赖完整的 Android 工具链： JDK、SDK、ADB、Gradle

所以，哪怕你只是写一行 console.log() ，背后也可能触发整个 Android 编译流程。任何一个环节断了，都会导致启动失败。

换句话说： 你不仅是个前端开发者，还得懂点 Android 构建体系。

第一步：安装 Node.js —— JS 生态的地基

没有 Node.js，一切免谈。React Native CLI 和 Metro 都基于它运行。

✅ 推荐版本 ：使用 LTS（长期支持）版本 ，目前建议选 v18.x 或 v20.x 。不要追求最新版，稳定性更重要。

你可以从 https://nodejs.org 下载安装包，或者用版本管理工具如 nvm （macOS/Linux 推荐）或 nvm-windows 。

安装完成后，打开终端验证：

node -v
npm -v

输出类似：

v18.17.0
9.6.7

✅ 只要能看到版本号，并且 Node ≥ 16，就没问题。

第二步：搞定 JDK —— 别让 Gradle 在半路翻车

很多人忽略这一点： Gradle 是跑在 JVM 上的 ，而 Android 项目的 Java/Kotlin 代码也需要编译。因此，必须安装合适的 JDK。

⚠️ 关键提示 ：
从 React Native 0.72 开始，官方推荐并默认使用 JDK 17 。
但注意！ 不能使用 JDK 18+ ，因为 Gradle 对高版本 JDK 支持