Appearance
安装 Node.js / Watchman / Xcode
Mac 系统环境搭建第一步
在 Mac 系统上搭建 React Native 开发环境，我们需要安装 Node.js、Watchman 和 Xcode。本节将详细介绍这些工具的安装步骤。
1. 安装 Node.js
Node.js 是 React Native 开发的基础，它提供了 JavaScript 运行环境和 npm 包管理器。
安装步骤
下载 Node.js
- 访问 Node.js 官方网站
- 下载 LTS 版本（长期支持版），推荐 18.x 或 20.x 版本
- 选择 macOS 安装包（.pkg）
安装 Node.js
- 双击下载的安装包
- 按照安装向导的提示进行安装
- 完成安装
验证安装
- 打开终端（Terminal）
- 运行以下命令：bash
node -v npm -v - 看到版本号输出，表示安装成功
2. 安装 Watchman
Watchman 是 Facebook 开发的文件监视器，用于提高 React Native 的开发效率。在 Mac 上，Watchman 是推荐安装的工具。
安装步骤
使用 Homebrew 安装 Watchman
- 打开终端
- 运行以下命令：bash
brew install watchman - 等待安装完成
验证安装
- 运行以下命令：bash
watchman --version - 看到版本号输出，表示安装成功
- 运行以下命令：
3. 安装 Xcode
Xcode 是 Apple 官方的 iOS 开发 IDE，它包含了 iOS SDK 和 iOS 模拟器等工具。
安装步骤
下载 Xcode
- 打开 App Store
- 搜索 "Xcode"
- 点击 "获取" 按钮下载并安装
安装 Xcode 命令行工具
- 打开终端
- 运行以下命令：bash
xcode-select --install - 按照提示完成安装
验证安装
- 运行以下命令：bash
xcodebuild -version - 看到版本号输出，表示安装成功
- 运行以下命令：
同意 Xcode 许可协议
- 运行以下命令：bash
sudo xcodebuild -license - 按照提示阅读并同意许可协议
- 运行以下命令：
4. 配置 npm 镜像（推荐）
由于网络原因，npm 官方镜像可能下载速度较慢，建议配置国内镜像以提高下载速度。
配置步骤
设置 npm 镜像
- 运行以下命令：bash
npm config set registry https://registry.npmmirror.com/
- 运行以下命令：
设置 yarn 镜像（如果使用 yarn）
- 运行以下命令：bash
yarn config set registry https://registry.npmmirror.com/
- 运行以下命令：
验证配置
- 运行以下命令：bash
npm config get registry - 看到输出
https://registry.npmmirror.com/，表示配置成功
- 运行以下命令：
5. 常见问题解决
Node.js 安装问题
问题：安装后无法运行 node 命令 解决：检查环境变量是否正确配置，重启终端
问题：npm 安装依赖失败 解决：配置国内镜像，或使用代理
Watchman 安装问题
问题：Homebrew 未安装 解决：先安装 Homebrew，运行
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"问题：Watchman 安装失败 解决：尝试更新 Homebrew 后重新安装，运行
brew update && brew install watchman
Xcode 安装问题
问题：Xcode 下载速度慢 解决：使用 App Store 下载，或考虑使用 Xcode 官方下载页面
问题：Xcode 命令行工具安装失败 解决：尝试从 Apple 开发者网站下载并安装
6. 总结
安装 Node.js、Watchman 和 Xcode 是 Mac 系统上 React Native 开发的基础步骤。确保这些工具都正确安装并配置后，我们就可以继续进行 iOS 模拟器和 Android 模拟器的配置了。
下一节，我们将介绍如何配置 iOS 模拟器和 Android 模拟器，为 React Native 开发做好准备。