macOS Monterey下安装CocoaPods后pod命令无法使用求助

问题现象 #

通过sudo gem install cocoapods安装CocoaPods后，执行pod install或pod setup时出现以下错误：

Unable to locate the CocoaPods.app application bundle. Please ensure the application is available and launch it at least once.
zsh: illegal hardware instruction pod

问题原因 #

1. 系统自带Ruby版本与CocoaPods最新版本存在兼容性冲突，且使用sudo安装会引发权限及架构适配问题
2. M系列芯片Mac上，直接用系统gem安装的CocoaPods可能存在架构不匹配，导致illegal hardware instruction错误

解决方案 #

1. 卸载现有通过gem安装的CocoaPods #

执行以下命令彻底卸载：

sudo gem uninstall cocoapods

如果提示存在多个版本，选择卸载所有版本。

2. 通过Homebrew重新安装CocoaPods（官方推荐方式） #

Homebrew会自动处理系统架构、依赖及权限问题：

• 先更新Homebrew：

  brew update
  

• 安装CocoaPods：

  brew install cocoapods
  

• 初始化CocoaPods：

  pod setup
  

3. M系列芯片额外适配（若上述步骤仍报错） #

如果是M1/M2等ARM架构Mac，尝试通过Rosetta兼容模式运行终端：

• 找到「终端」应用，右键选择「显示简介」，勾选「使用Rosetta打开」
• 重启终端后重新执行pod install或pod setup
• 或者直接通过Rosetta架构安装：

  arch -x86_64 brew install cocoapods
  

内容的提问来源于stack exchange，提问作者Muhammad Danish Qureshi