你遇到的是一串连锁问题，根源大多和Xcode命令行工具未正确配置、第三方库路径未被Ruby识别有关，咱们一步步拆解解决：

第一步：修复Xcode命令行工具（核心根源） #

stdio.h缺失、无法运行C编译器这类问题，本质都是Xcode命令行工具没装全或路径配置错误导致的：

• 先卸载可能损坏的旧工具：

  sudo rm -rf /Library/Developer/CommandLineTools
  

• 重新安装命令行工具：

  xcode-select --install
  

• 确认路径配置正确：

  xcode-select -p
  

  正常输出应为/Library/Developer/CommandLineTools，如果不是，手动指定：

  sudo xcode-select -s /Library/Developer/CommandLineTools
  

• 关键一步：打开Xcode，同意许可协议并完成组件安装，否则后续编译会莫名报错。

第二步：让Ruby识别brew安装的libffi路径 #

brew安装的libffi默认不在系统默认链接路径里，导致Ruby编译ffi扩展时找不到它，我们手动指定路径：

• 先找到brew安装的libffi位置：

  brew info libffi
  

  输出里会有类似/usr/local/opt/libffi的路径，记下来。
• 设置环境变量（临时生效，后续可加到~/.zshrc或~/.bashrc永久生效）：

  export LDFLAGS="-L$(brew --prefix libffi)/lib"
  export CPPFLAGS="-I$(brew --prefix libffi)/include"
  export PKG_CONFIG_PATH="$(brew --prefix libffi)/lib/pkgconfig"
  

第三步：用rbenv正确配置Ruby环境 #

系统Ruby权限问题多，rbenv是更稳妥的版本管理工具，现在解决Ruby编译失败问题：

• 重装rbenv和ruby-build（避免之前的安装残留）：

  brew uninstall rbenv ruby-build
  brew install rbenv ruby-build
  

• 把rbenv加到shell配置（以zsh为例，bash用户替换成.bashrc）：

  echo 'eval "$(rbenv init - zsh)"' >> ~/.zshrc
  

• 重启终端或刷新配置：

  source ~/.zshrc
  

• 安装兼容CocoaPods的Ruby版本（推荐3.2.2，版本太新太旧都可能出问题）：

  rbenv install 3.2.2
  

  这时候因为第一步修复了XCLT，应该能正常编译Ruby了。
• 设置Ruby版本（全局或项目本地均可）：

  # 全局设置
  rbenv global 3.2.2
  # 或仅当前RN项目生效
  cd 你的RN项目目录
  rbenv local 3.2.2
  

• 确认版本生效：

  ruby -v
  

第四步：安装CocoaPods并修复pod install问题 #

现在Ruby环境和libffi路径都正常了，安装CocoaPods：

• 先更新gem源（避免国内网络问题）：

  gem sources --remove https://rubygems.org/
  gem sources --add https://gems.ruby-china.com/
  # 确认只有国内源
  gem sources -l
  

• 安装CocoaPods（不要用sudo，rbenv管理的Ruby是用户级的）：

  gem install cocoapods
  

  这时候ffi扩展应该能正常编译了。
• 验证pod命令可用：

  pod --version
  

• 回到RN项目清理旧缓存，重新执行pod install：

  cd ios
  pod deintegrate
  pod clean
  rm -rf Podfile.lock
  pod install
  

额外小Tips #

如果还是遇到libffi加载问题，可临时添加动态库路径：

export DYLD_LIBRARY_PATH="$(brew --prefix libffi)/lib:$DYLD_LIBRARY_PATH"

内容的提问来源于stack exchange，提问作者zendevil.eth