选择Xcode命令行工具后React Native初始化失败求助

核心原因 #

你的问题本质是Xcode版本与macOS系统不兼容导致的环境冲突：

• macOS 12.6.7（Monterey）对应的最低兼容Xcode版本是13.0，而你安装的Xcode 12.2是为macOS 11（Big Sur）设计的，两者的Command Line Tools（CLT）、SDK路径、Ruby头文件完全不匹配。
• 系统Ruby（2.6.0）依赖Xcode/CLT提供的编译工具和头文件，版本不兼容时，要么找不到编译工具（未选CLT），要么找不到正确的Ruby头文件（选CLT），导致Gem原生扩展编译失败。

彻底解决步骤 #

1. 卸载不兼容的Xcode与CLT #

• 把Xcode 12.2拖到废纸篓并清空。
• 删除旧的CLT：

  sudo rm -rf /Library/Developer/CommandLineTools
  

2. 安装适配的Xcode版本 #

下载适配macOS 12.6.7的Xcode版本（推荐Xcode 14.2或14.3.1，这两个版本完美兼容Monterey），可通过Apple开发者网站或App Store安装（App Store会自动匹配兼容版本）。

3. 配置CLT与Xcode路径 #

• 打开新安装的Xcode，接受许可协议，等待组件安装完成。
• 配置xcode-select指向正确的Xcode路径：

  sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
  

• 验证配置：

  xcode-select -p
  

  输出应为/Applications/Xcode.app/Contents/Developer

4. 验证Ruby环境 #

测试能否正常安装需要的Gem：

gem install json -v 2.6.3

如果安装成功，说明环境已修复，此时直接执行npx react-native init即可正常初始化项目。

临时方案原理 #

你发现的「先选CLT，待Gem安装完成后重置」的方法，本质是利用了：

• 选CLT时，系统能找到编译工具完成Gem原生扩展的编译；
• 重置CLT（xcode-select -r）后，RN依赖安装阶段会使用Xcode内置的SDK和工具，刚好避开了版本不兼容的冲突点。但这只是绕过问题，不是根本解决。

内容的提问来源于stack exchange，提问作者Wisam Jbori