新建Xcode项目执行pod install时报Ruby相关非法指令错误

该错误为Apple Silicon（M1/M2等）系列Mac设备特有的兼容问题：系统自带的Ruby 2.6版本与CocoaPods依赖的ethon 0.14.0库存在架构适配缺陷，运行时触发非法指令崩溃。

方案1：单次应急解决 #

无需修改任何配置，直接在项目目录下执行如下命令即可完成依赖安装：
arch -x86_64 pod install

方案2：临时全局解决（适合短期开发） #

• 右键访达「应用程序-实用工具」中的「终端」，选择「显示简介」
• 勾选「使用Rosetta打开」选项，关闭所有已打开的终端窗口后重启终端
• 进入项目目录直接执行pod install即可正常运行

方案3：长期稳定解决（推荐） #

替换系统自带的低版本Ruby，安装适配ARM架构的高版本Ruby：

• 先安装Homebrew包管理工具
• 执行命令安装新版Ruby：brew install ruby
• 打开终端配置文件~/.zshrc，添加如下环境变量配置：

export PATH=/opt/homebrew/opt/ruby/bin:$PATH
export LDFLAGS="-L/opt/homebrew/opt/ruby/lib"
export CPPFLAGS="-I/opt/homebrew/opt/ruby/include"

• 执行source ~/.zshrc使配置生效，运行ruby -v确认版本号高于2.6.x即配置成功
• 执行命令重新安装CocoaPods：sudo gem install cocoapods
• 进入项目目录执行pod install即可正常使用

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