React-Native 开发环境搭建

2025-12-30

入坑需谨慎，且入且珍惜🤣 本文章适用于准备入坑的新手观看，也欢迎各位大佬拍砖🙏！

准备工作

需要的硬件

首先电脑(Windows、Mac都行)是必须的啊（没有电脑你还想开发😏），有条件的小伙伴可以准备一部手机，没有手机也可以使用模拟器（详见需要的软件）,硬件的准备就完成了，接下来看看需要哪些软件吧！

需要的软件

Node 和 React-Native

这个直接跟着react-native官方网站操作就行了！官方使用yarn用作包管理器的，使用 npm i yarn -g 安装就行！

1 2	# 顺便贴一下npm 淘宝镜像的设置 npm config set registry https://registry.npmmirror.com

Java环境配置

java安装强烈建议使用java版本管理器，这样不需要你手动配置环境变量了，在win上建议使用 jvms 来进行java版本管理，可点击链接查看使用指南！在mac电脑推荐使用 jenv 来进行管理；在管理安装成功后安装 17.0.6 版本的java包！

Android工具包

在你要放置的盘符下新建一个 android-sdk 的文件夹，尽量不要放在C盘，尽量放在根目录；mac用户随意新建，只要不包含空格的路径下就行！
下载平台工具，打开 platform-tools官网找到你对应系统的工具包，然后在弹窗中滚动到底部同意条款后就可以下载了。下载完成后解压将 platform-tools 整个文件夹放到第一步创建的 android-sdk 文件夹下。
下载命令行工具，打开 command-tools官网后向下滚动，找到 仅限命令行工具 下载你对应平台的压缩包，下载完成后解压将 cmdline-tools 整个文件夹放到 android-sdk 文件夹下，然后进入 cmdline-tools 文件夹，新建 latest 文件夹，然后将 cmdline-tools 下的所有文件和文件夹移动到 latest 文件夹下。

配置环境变量

win系统中点击桌面底部的搜索，输入 编辑系统环境变量 ，然后依次点击环境变量 → 系统变量 → 新建，然后变量名是：ANDROID_HOME ，变量值是： D:\android-sdk，记得把盘符换成你自己的，然后找到系统变量下的 Path 变量，添加 %ANDROID_HOME%\cmdline-tools\latest\bin 和 %ANDROID_HOME%\platform-tools 行后确认。

mac系统中，只需要打开终端，输入 open ~/.bash_profile 或者你使用zsh则输入 open ~/.zshrc ，在文件中添加（替换你的SDK路径）

export ANDROID_HOME=$HOME/Library/android-sdk
export PATH=$PATH:$ANDROID_HOME/cmdline-tools/latest/bin
export PATH=$PATH:$ANDROID_HOME/platform-tools
export PATH=$PATH:$ANDROID_HOME/emulator
export PATH=$PATH:$ANDROID_HOME/tools/bin

保存后再在终端中运行 `source ~/.zshrc` 或 `source ~/.bash_profile` 生效。

配置完环境变量后打开CMD或者终端，运行 sdkmanager --licenses 同意许可，一直输入 y 就行了，然后运行 sdkmanager "platform-tools" "platforms;android-36" "build-tools;36.0.0" 安装工具，根据你自己需要的版本安装。
验证：输入 adb version 和 sdkmanager --list 都能输出版本/列表就 OK。后续用 sdkmanager --update 更新一切。

运行项目

首次运行android项目先执行 cd android && ./gradlew clean --refresh-dependencies 会下载安卓的相关依赖，如果首次运行下载gradle报错超时的话，可以复制下载链接，比如 https://services.gradle.org/distributions/gradle-9.0.0-bin.zip ，用浏览器打开下载到本地，然后将下载好的压缩包放到 User\[用户名] 下的 .gradle\wrapper\dist\gradle-9.0.0-bin\[随机的文件夹名] 文件夹下，再运行命令就会直接用本地文件，不会下载超时了。如果没有代理的话可以将域名换成华为云的，也就是 https://mirrors.huaweicloud.com/gradle/gradle-9.0.0-bin.zip 进行下载。

iOS开发环境配置

iOS开发的环境就比较简单了，首先mac电脑是必须的，然后根据react-native官网配置，安装了 watchman 和 Xcode 就行了。不得不说mac开发太省心了！😄