执行npx react-native init创建RN项目时Ruby Gem构建失败求助

这个错误源于json 2.6.3的原生扩展编译失败，通常和Ruby版本兼容性、Xcode命令行工具缺失或系统依赖配置有关。以下是针对性的解决步骤：

1. 升级或更换Ruby版本 #

系统自带的Ruby（如2.6.0）常存在权限或依赖限制，建议用版本管理工具切换到更稳定的2.7.x或3.0.x版本：

• 若用rbenv：

  rbenv install 2.7.8
  rbenv global 2.7.8
  

• 若用rvm：

  rvm install 2.7
  rvm use 2.7 --default
  

执行ruby -v确认版本切换成功。

2. 安装/更新Xcode命令行工具 #

原生扩展编译依赖Xcode工具链，执行以下命令确保工具完整：

xcode-select --install

也可打开Xcode，在Preferences -> Locations中确认Command Line Tools已选择对应版本。

3. 手动编译安装json gem #

执行报错提示的命令并添加编译参数，绕过系统依赖问题：

gem install json -v '2.6.3' -- --use-system-libraries

若仍失败，且已通过Homebrew安装openssl，可指定openssl路径：

gem install json -v '2.6.3' -- --with-openssl-dir=$(brew --prefix openssl)

4. 清理后重新初始化项目 #

• 删除原有失败项目目录：

  rm -rf AwesomeProject223
  

• 清理Ruby gem缓存：

  gem cleanup
  

• 重新执行初始化命令：

  npx react-native init AwesomeProject
  

5. 升级CocoaPods规避旧依赖链 #

原问题中CocoaPods 1.12.1依赖的algoliasearch 1.27.5绑定了旧版json，升级CocoaPods到最新版可更换依赖链：

gem install cocoapods

之后重新初始化项目，或进入项目目录执行pod install。

内容的提问来源于stack exchange，提问作者Yash Jadhav