iOS 开发环境（RN 0.72）

iOS 构建链是 Node → Ruby → CocoaPods → Xcode 四层，任何一层版本不匹配，报错都会指向下一层，看起来像 RN 的问题。

版本约束先对齐

RN 0.72 的 Gemfile 写的是 ruby ">= 2.7.6"。macOS 系统自带的 /usr/bin/ruby 是 2.6.x（原文记录的 2.6.10 就是它，不是 Homebrew 装的），所以直接用系统 Ruby 会在 bundle install 阶段被拦下。

组件	0.72 的要求	检查命令
Node	>= 16（建议 18 LTS）	node -v
Ruby	>= 2.7.6	ruby -v
CocoaPods	>= 1.11	pod --version
Xcode	>= 14.3	xcodebuild -version
Xcode CLT	与 Xcode 同版本	xcode-select -p

原文记录的可用 Ruby 是 3.x 版本（写的是 3.4）。实际建议用 3.1/3.2，这是 CocoaPods 生态验证最充分的区间；3.3+ 偶尔会遇到 ffi 编译问题。

用 rbenv 管 Ruby 版本

系统 Ruby 不要动，用 rbenv 装一份项目专用的：

brew install rbenv ruby-build

# 写进 ~/.zshrc，否则新开终端找不到 rbenv 装的版本
eval "$(rbenv init - zsh)"

rbenv install 3.2.2
rbenv global 3.2.2        # 或进项目目录后 rbenv local 3.2.2
ruby -v                   # 确认输出 3.2.2，不是 2.6.x

关键点：rbenv init 必须写进 shell 配置，并且 ~/.rbenv/shims 要排在 PATH 前面，否则 which ruby 仍指向 /usr/bin/ruby。这是「装了 3.2 但 bundle 还说版本低」的唯一原因。

rbenv install -l 看可装版本，rbenv versions 看已装版本，rbenv local 3.2.2 在当前目录写 .ruby-version 让版本跟着项目走。

安装依赖与 Pods

# 1. 装 bundle 与项目依赖（在 ios 同级的项目根目录）
gem install bundler
bundle install

# 2. 装 Pods（Ruby 依赖装完后才能跑）
cd ios && bundle exec pod install && cd ..

新版 RN 推荐用 bundle exec pod install 而不是裸 pod install，保证用的是 Gemfile 锁定的 CocoaPods 版本。换 Ruby 版本或改了 Podfile 之后，先删 Pods/ 与 Podfile.lock 再装。

Xcode 首次打开项目后，还要在 Settings → Locations 里把 Command Line Tools 设成对应的 Xcode，否则 xcodebuild 找不到 SDK。

常见报错对照

报错	真实原因	处理