如何搭建react native
搭建 React Native 开发环境
安装 Node.js 和 npm
React Native 需要 Node.js 环境,建议安装最新 LTS 版本。可以从 Node.js 官网 下载并安装。安装完成后,运行以下命令检查版本:
node -v
npm -v
安装 Java Development Kit (JDK)
React Native 的 Android 开发需要 JDK 11 或更高版本。可以从 Oracle JDK 或 OpenJDK 下载并安装。安装完成后检查版本:
java -version
安装 Android Studio
Android Studio 提供 Android SDK 和模拟器。从 Android Studio 官网 下载并安装。安装完成后,打开 Android Studio,配置 Android SDK 并确保以下工具已安装:
- Android SDK
- Android Emulator
- Android Platform Tools
配置环境变量
将 Android SDK 路径添加到系统环境变量中。在 ~/.bashrc 或 ~/.zshrc 文件中添加以下内容:
export ANDROID_HOME=$HOME/Android/Sdk
export PATH=$PATH:$ANDROID_HOME/emulator
export PATH=$PATH:$ANDROID_HOME/platform-tools
创建 React Native 项目
安装 React Native CLI
使用 npm 全局安装 React Native 命令行工具:
npm install -g react-native-cli
初始化项目
运行以下命令创建新项目:
npx react-native init ProjectName
将 ProjectName 替换为你的项目名称。
运行项目
进入项目目录并启动 Metro 打包工具:
cd ProjectName
npx react-native start
在另一个终端窗口中运行应用:
npx react-native run-android
或 iOS 开发(需 macOS 环境):
npx react-native run-ios
配置 iOS 开发环境(仅 macOS)
安装 Xcode
从 Mac App Store 安装 Xcode。安装完成后,打开 Xcode 并同意许可协议。
安装 CocoaPods
CocoaPods 是 iOS 依赖管理工具。运行以下命令安装:
sudo gem install cocoapods
安装 iOS 依赖
进入项目目录的 ios 文件夹并安装依赖:
cd ios
pod install
测试开发环境
检查环境配置
运行以下命令检查 React Native 环境是否配置正确:
npx react-native doctor
根据提示修复任何问题。
启动模拟器
Android 开发可以通过 Android Studio 启动模拟器,iOS 开发可以通过 Xcode 启动模拟器。确保模拟器运行后再启动项目。
开发工具推荐
代码编辑器
推荐使用 Visual Studio Code 或 WebStorm 进行开发。
调试工具
- React Developer Tools:调试 React 组件。
- Flipper:用于调试 React Native 应用。
- Chrome DevTools:用于调试 JavaScript 代码。
常见问题解决
Android 设备连接问题
确保设备已启用 USB 调试模式。在设备上打开开发者选项并启用 USB 调试。
iOS 模拟器问题
确保 Xcode 已正确安装并配置。如果模拟器无法启动,尝试重启 Xcode 或电脑。

依赖冲突
如果遇到依赖冲突,尝试删除 node_modules 和 package-lock.json,然后重新运行 npm install。






