CocoaPods版本异常求助：已装1.12.1却调用1.11.3执行pod install报错

以下是几个针对性的排查和解决步骤：

• 确认pod命令的实际调用路径
  执行以下命令查看当前pod命令的位置：

  which pod
  

  同时查看Homebrew安装CocoaPods的路径：

  brew --prefix cocoapods
  

  如果两者路径不匹配（比如前者指向/usr/bin/pod或其他非Homebrew路径），说明Shell的PATH优先级导致调用了旧版本。此时需要将Homebrew的CocoaPods路径加到PATH最前端：

  1. 打开Shell配置文件（比如~/.zshrc或~/.bash_profile）
  2. 添加一行：export PATH="$(brew --prefix cocoapods)/bin:$PATH"
  3. 执行source ~/.zshrc（对应你的配置文件）刷新环境

• 清除Shell命令缓存
  有时Shell会缓存命令路径，即便你更新了版本也不会立即生效，执行以下命令清除缓存：

  hash -r
  

  之后再运行pod --version验证版本是否正确。

• 排查Ruby版本管理器的干扰
  如果你使用了rvm、rbenv这类Ruby版本管理器，不同Ruby环境可能安装了不同版本的CocoaPods：

  • 查看当前Ruby环境：

    # 若用rvm
    rvm list
    # 若用rbenv
    rbenv versions
    

  • 切换到安装了CocoaPods 1.12.1的Ruby环境，重新执行sudo gem install cocoapods确保该环境下版本正确；如果不需要版本管理器，可直接卸载避免冲突。

• 查找并删除残留的旧版可执行文件
  系统中可能存在多个pod可执行文件，执行以下命令找出所有位置：

  find / -name pod -type f -executable 2>/dev/null
  

  对每个找到的路径，执行/path/to/pod --version检查版本，将对应1.11.3的旧版文件删除（注意：操作前确认路径，避免误删系统文件）。

• 检查Xcode自带工具的影响
  部分Xcode版本可能自带CocoaPods，执行以下命令查看Xcode自带的pod版本：

  /Applications/Xcode.app/Contents/Developer/usr/bin/pod --version
  

  如果该版本是1.11.3，且PATH中Xcode的usr/bin优先级高于Homebrew路径，需调整PATH顺序，将Homebrew路径放在前面。

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