1. React Native 环境搭建全流程解析作为移动端跨平台开发的主流框架React Native 凭借其Learn once, write anywhere的特性深受开发者青睐。但在开始开发前环境搭建这个拦路虎常常让新手望而却步。本文将基于最新稳定版0.73详细拆解 Windows/macOS/Linux 三大平台的环境配置要点特别针对国内网络环境提供优化方案。重要提示React Native 0.73 版本要求 Node 18 和 JDK 17低于此版本可能导致兼容性问题。建议在开始前卸载旧版全局 CLInpm uninstall -g react-native-cli1.1 基础依赖安装Node.js 环境配置版本选择必须使用 LTS 版本当前推荐 18.x镜像优化解决 npm 安装慢问题# 使用 nrm 切换淘宝源 npx nrm use taobao # 验证是否生效 npm config get registryYarn 替代 npmnpm install -g yarnJDK 安装注意事项版本要求必须匹配 JDK 17Zulu OpenJDK 推荐验证安装javac -version # 应显示 17.x.x多版本管理适用于需要兼容旧项目macOS: 使用jenvWindows: 通过环境变量切换2. Android 开发环境精讲2.1 Android Studio 定制安装下载后选择Custom 安装必须勾选Android SDKAndroid SDK PlatformAndroid Virtual DevicePerformance (Intel® HAXM 或 Hypervisor)SDK 组件配置Platforms: Android 13 (Tiramisu) API 33Build-Tools: 33.0.0必须镜像文件根据 CPU 类型选择Intel: x86_64Apple Silicon: ARM64实测数据完整安装需要约 8GB 磁盘空间首次构建会额外下载约 2GB 依赖2.2 环境变量配置各系统示例macOS/Linux~/.zshrc 或 ~/.bash_profileexport ANDROID_HOME$HOME/Library/Android/sdk export PATH$PATH:$ANDROID_HOME/platform-tools export PATH$PATH:$ANDROID_HOME/cmdline-tools/latest/binWindows 环境变量变量名ANDROID_HOME 变量值C:\Users\[用户名]\AppData\Local\Android\Sdk Path 追加 %ANDROID_HOME%\platform-tools %ANDROID_HOME%\emulator2.3 模拟器优化技巧性能调优开启虚拟化BIOS 中启用 VT-x/AMD-V分配内存建议4GB开发机至少 8GB 物理内存常见问题处理# 查看可用设备列表 emulator -list-avds # 启动模拟器时禁用音频 emulator 设备名 -no-audio3. 项目初始化与运行3.1 创建新项目npx react-nativelatest init MyProject --template react-native-template-typescript关键参数说明--version指定 RN 版本如 0.73.4--template支持社区模板推荐 TypeScript3.2 首次运行避坑指南网络问题解决方案修改 android/build.gradlerepositories { maven { url https://maven.aliyun.com/repository/google } maven { url https://maven.aliyun.com/repository/public } }常见错误处理Could not determine java version检查 JDK 版本SDK location not found确认 ANDROID_HOME 配置Gradle build daemon disappeared增加内存设置org.gradle.jvmargs-Xmx4096m -XX:MaxPermSize1024m4. 开发工作流优化4.1 Metro 打包器配置在项目根目录创建metro.config.jsmodule.exports { transformer: { getTransformOptions: async () ({ transform: { experimentalImportSupport: false, inlineRequires: true, }, }), }, maxWorkers: 2, // 根据 CPU 核心数调整 };4.2 调试技巧真机调试adb devices # 查看连接设备 yarn android --deviceId设备ID性能分析React DevTools独立安装Flipper官方推荐5. 多环境管理方案5.1 Node 版本管理推荐使用nvmWindows 可用nvm-windowsnvm install 18 nvm use 185.2 JDK 版本切换macOS 方案brew install jenv jenv add /Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home jenv global 176. 进阶配置指南6.1 自定义打包参数在 android/gradle.properties 中添加# 启用新架构0.68 newArchEnabledtrue6.2 离线模式支持提前下载依赖./gradlew --refresh-dependencies设置离线标志android { lintOptions { checkDependencies false } }7. 环境验证清单执行以下命令验证环境完整性npx react-native doctor预期输出应包含✔ Node.js ✔ JDK ✔ Android Studio ✔ Android SDK我在实际企业级项目中的经验是首次环境搭建建议预留 2-3 小时视网络情况遇到问题时优先检查控制台完整错误日志gradlew 的报错文件android/.gradle/daemon/版本/Metro 服务是否正常启动默认端口 8081
React Native 0.73+ 跨平台开发环境搭建指南
发布时间：2026/7/19 1:53:07
1. React Native 环境搭建全流程解析作为移动端跨平台开发的主流框架React Native 凭借其Learn once, write anywhere的特性深受开发者青睐。但在开始开发前环境搭建这个拦路虎常常让新手望而却步。本文将基于最新稳定版0.73详细拆解 Windows/macOS/Linux 三大平台的环境配置要点特别针对国内网络环境提供优化方案。重要提示React Native 0.73 版本要求 Node 18 和 JDK 17低于此版本可能导致兼容性问题。建议在开始前卸载旧版全局 CLInpm uninstall -g react-native-cli1.1 基础依赖安装Node.js 环境配置版本选择必须使用 LTS 版本当前推荐 18.x镜像优化解决 npm 安装慢问题# 使用 nrm 切换淘宝源 npx nrm use taobao # 验证是否生效 npm config get registryYarn 替代 npmnpm install -g yarnJDK 安装注意事项版本要求必须匹配 JDK 17Zulu OpenJDK 推荐验证安装javac -version # 应显示 17.x.x多版本管理适用于需要兼容旧项目macOS: 使用jenvWindows: 通过环境变量切换2. Android 开发环境精讲2.1 Android Studio 定制安装下载后选择Custom 安装必须勾选Android SDKAndroid SDK PlatformAndroid Virtual DevicePerformance (Intel® HAXM 或 Hypervisor)SDK 组件配置Platforms: Android 13 (Tiramisu) API 33Build-Tools: 33.0.0必须镜像文件根据 CPU 类型选择Intel: x86_64Apple Silicon: ARM64实测数据完整安装需要约 8GB 磁盘空间首次构建会额外下载约 2GB 依赖2.2 环境变量配置各系统示例macOS/Linux~/.zshrc 或 ~/.bash_profileexport ANDROID_HOME$HOME/Library/Android/sdk export PATH$PATH:$ANDROID_HOME/platform-tools export PATH$PATH:$ANDROID_HOME/cmdline-tools/latest/binWindows 环境变量变量名ANDROID_HOME 变量值C:\Users\[用户名]\AppData\Local\Android\Sdk Path 追加 %ANDROID_HOME%\platform-tools %ANDROID_HOME%\emulator2.3 模拟器优化技巧性能调优开启虚拟化BIOS 中启用 VT-x/AMD-V分配内存建议4GB开发机至少 8GB 物理内存常见问题处理# 查看可用设备列表 emulator -list-avds # 启动模拟器时禁用音频 emulator 设备名 -no-audio3. 项目初始化与运行3.1 创建新项目npx react-nativelatest init MyProject --template react-native-template-typescript关键参数说明--version指定 RN 版本如 0.73.4--template支持社区模板推荐 TypeScript3.2 首次运行避坑指南网络问题解决方案修改 android/build.gradlerepositories { maven { url https://maven.aliyun.com/repository/google } maven { url https://maven.aliyun.com/repository/public } }常见错误处理Could not determine java version检查 JDK 版本SDK location not found确认 ANDROID_HOME 配置Gradle build daemon disappeared增加内存设置org.gradle.jvmargs-Xmx4096m -XX:MaxPermSize1024m4. 开发工作流优化4.1 Metro 打包器配置在项目根目录创建metro.config.jsmodule.exports { transformer: { getTransformOptions: async () ({ transform: { experimentalImportSupport: false, inlineRequires: true, }, }), }, maxWorkers: 2, // 根据 CPU 核心数调整 };4.2 调试技巧真机调试adb devices # 查看连接设备 yarn android --deviceId设备ID性能分析React DevTools独立安装Flipper官方推荐5. 多环境管理方案5.1 Node 版本管理推荐使用nvmWindows 可用nvm-windowsnvm install 18 nvm use 185.2 JDK 版本切换macOS 方案brew install jenv jenv add /Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home jenv global 176. 进阶配置指南6.1 自定义打包参数在 android/gradle.properties 中添加# 启用新架构0.68 newArchEnabledtrue6.2 离线模式支持提前下载依赖./gradlew --refresh-dependencies设置离线标志android { lintOptions { checkDependencies false } }7. 环境验证清单执行以下命令验证环境完整性npx react-native doctor预期输出应包含✔ Node.js ✔ JDK ✔ Android Studio ✔ Android SDK我在实际企业级项目中的经验是首次环境搭建建议预留 2-3 小时视网络情况遇到问题时优先检查控制台完整错误日志gradlew 的报错文件android/.gradle/daemon/版本/Metro 服务是否正常启动默认端口 8081
