macOS 下 React Native 开发环境配置指南

一、Node.js 版本控制（推荐使用 nvm）

1. 安装 nvm
   在终端执行：

   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash  
   

   重启终端后验证安装：nvm --version

2. 管理 Node.js 版本

   nvm install 18.17.1  # 安装 LTS 版本（React Native 推荐）  
   nvm use 18.17.1      # 切换版本  
   nvm alias default 18.17.1  # 设为默认  
   

3. 验证安装

   node -v  # 应输出 v18.17.1  
   npm -v   # 验证 npm 版本  
   

二、iOS 真机调试步骤

前提：

• macOS 系统 ≥ 12.0
• Xcode ≥ 14.0（通过 App Store 安装）
• Apple 开发者账号（免费账户支持基础调试）

步骤：

1. 配置 Xcode

   • 打开 Xcode → Xcode → Settings → Accounts
   • 登录 Apple ID，勾选 Personal Team

2. 连接设备

   • 用 Lightning 线连接 iPhone/iPad
   • 设备弹窗选择 信任此电脑

3. 修改 React Native 项目配置

   • 在项目根目录执行：

     cd ios && pod install  # 安装 CocoaPods 依赖  
     

   • 用 Xcode 打开 ios/YourProjectName.xcworkspace

4. 设置签名与设备

   • 在 Xcode 顶部菜单：

     Target → YourProjectName → Signing & Capabilities  
     

     • Team: 选择您的 Apple ID
     • Bundle Identifier: 修改为唯一值（如 com.yourname.app）

5. 启动调试

   • 选择连接的设备（顶部工具栏）
   • 点击 ▶ 运行按钮
   • 首次运行需在设备上手动信任证书：

     设置 → 通用 → VPN与设备管理 → 开发者App → 信任  
     

6. 启用热重载

   • 摇动设备调出调试菜单 → 启用 Hot Reloading

三、常见问题排查

• 设备无法识别：

  sudo killall -STOP usbd  # 重启 USB 守护进程  
  

• 签名错误：
  Xcode → Product → Clean Build Folder
• 网络请求失败：
  在 Info.plist 中添加：

  <key>NSAppTransportSecurity</key>  
  <dict>  
    <key>NSAllowsArbitraryLoads</key>  
    <true/>  
  </dict>  
  

提示：真机调试需保持设备与 Mac 在同一 WiFi 网络，建议关闭 macOS 防火墙（系统设置 → 隐私与安全性 → 防火墙）。