0. 环境架构概览#

在开始安装之前，我们需要了解 React Native 开发环境的组成部分。它不仅需要 JavaScript 运行环境，还需要完整的 Android 原生开发链。

1. 基础工具安装 (使用 Chocolatey)#

Chocolatey 是 Windows 上最强大的包管理器，能帮我们一键安装复杂的开发工具。以管理员权限打开 PowerShell，安装 Chocolatey 后运行以下命令：

1
# 安装 Node.js (LTS), JDK 17 (当前RN推荐版本) 和 Python3
2
choco install -y nodejs-lts microsoft-openjdk17 python3

注意：2026 年的 React Native 已经全面转向 JDK 17，旧版的 JDK 8 可能会导致现代 Gradle 构建失败。

2. 安装 React Native 命令行工具#

现在官方不再建议全局安装 react-native-cli。推荐使用 npx（随 Node.js 自动安装），这样可以确保你始终使用最新版本的脚手架，而不会产生版本冲突。

1
# 无需安装，直接运行创建命令
2
npx react-native init MyProject

3. Android Studio 与 SDK 配置#

4. 关键步骤：配置环境变量#

这是 Windows 用户最容易卡住的地方。React Native 需要通过环境变量定位 SDK。

1. 新建系统变量：

• 变量名：ANDROID_HOME
• 变量值：你的 SDK 路径（通常为 C:\Users\用户名\AppData\Local\Android\Sdk）

2. 编辑 Path 变量： 在系统变量 Path 中添加以下四个路径：

• %ANDROID_HOME%\platform-tools
• %ANDROID_HOME%\emulator
• %ANDROID_HOME%\tools
• %ANDROID_HOME%\tools\bin

5. 启动 Android 模拟器 (AVD)#

1. 在 Android Studio 中点击 Device Manager。
2. 点击 Create Device，选择一个设备型号（如 Pixel 7）。
3. 选择一个系统镜像（推荐 x86_64 以获得更佳性能）并下载。
4. 完成后点击“播放”按钮启动模拟器。

6. 创建与运行项目#

1
npx react-native init MyAwesomeProject
2
cd MyAwesomeProject
3
npm run android

1
npx create-expo-app MyExpoProject
2
cd MyExpoProject
3
npx expo start

7. 常见问题避坑指南#

• 模拟器启动黑屏：检查是否开启了 VT-x (Intel) 或 SVM (AMD) 硬件虚拟化技术。你需要在 BIOS 中开启此项。
• Build 报错 “Could not install the app on the device”：通常是环境变量没配对，或者模拟器未完全启动，运行 adb devices 检查是否有设备在线。
• 性能优化：在 Windows 上，确保你的模拟器开启了 Graphics: Hardware - GLES 2.0 以利用显卡加速。

总结#

搭建 React Native 环境的过程虽然繁琐，但只要配置好了 环境变量 和 SDK 组件，后续的开发体验会非常流畅。2026 年的开发趋势是尽量利用 npx 减少全局依赖，并保持 JDK 版本的更新。