简单到爆，一文读懂React Native 环境搭建与项目创建

一、环境搭建

1. 系统要求

macOS: 支持 Intel 和 Apple Silicon 芯片
Windows: 10 或更高版本
Linux: Ubuntu 18.04 或更高版本

2. 安装 Node.js

推荐使用 LTS 版本 (16.x 或更高):

# 使用 nvm (推荐)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
nvm install --lts
nvm use --lts

# 或直接安装
# Windows: 从 https://nodejs.org/ 下载安装包
# Mac: brew install node

3. 安装 Java Development Kit (JDK)

React Native 需要 JDK 11:

# Mac
brew tap homebrew/cask-versions
brew install --cask zulu11

# Windows/Linux: 从 https://www.azul.com/downloads/ 下载 Zulu JDK 11

4. 安装 Android Studio (Android 开发)

下载并安装 Android Studio
安装时选择:

Android SDK
Android SDK Platform
Android Virtual Device

配置环境变量:

# ~/.bash_profile 或 ~/.zshrc (Mac/Linux)
export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/emulator
export PATH=$PATH:$ANDROID_HOME/platform-tools

# Windows: 在系统环境变量中添加

5. 安装 Xcode (iOS 开发, Mac 专属)

从 App Store 安装 Xcode
安装命令行工具:

xcode-select --install

安装 CocoaPods:

sudo gem install cocoapods

6. 安装 React Native CLI

npm install -g react-native-cli
# 或使用 npx (推荐)

二、创建新项目

方法1: 使用 React Native CLI

npx react-native init AwesomeProject
# 如需指定版本
npx react-native init AwesomeProject --version 0.68.2

方法2: 使用 Expo (更简单但功能略有限制)

npm install -g expo-cli
expo init AwesomeProject
# 选择模板 (推荐 "blank" 或 "minimal")

三、运行项目

Android

cd AwesomeProject
npx react-native run-android
# 或通过 Android Studio 运行

iOS (Mac only)

cd AwesomeProject
npx react-native run-ios
# 或通过 Xcode 打开 ios/AwesomeProject.xcworkspace 运行

四、项目结构说明

AwesomeProject/
├── android/        # Android 原生代码
├── ios/            # iOS 原生代码
├── node_modules/   # 依赖库
├── __tests__/      # 测试文件
├── .gitignore      # Git 忽略规则
├── App.js          # 主组件文件
├── app.json        # 应用配置
├── babel.config.js # Babel 配置
├── index.js        # 入口文件
├── metro.config.js # Metro 打包配置
└── package.json    # 项目配置和依赖