macOS 10.15.7 Catalina下Homebrew安装CocoaPods失败 始终为1.5.2版

问题现象 #

• 系统环境：macOS 10.15.7 Catalina
• 执行安装操作：运行brew install cocoapods完成安装流程
• 版本校验结果：运行pod --version始终返回1.5.2版本，无法升级到目标1.10.1版本

解决操作步骤 #

• 重置更新Homebrew本地元数据
  10.15系统属于Homebrew旧版支持周期，长期未执行更新操作会导致本地缓存的软件包列表停留在多年前的版本，这是默认拉取到1.5.2旧版CocoaPods的常见原因。依次执行命令完成索引重置：
  brew update-reset
brew update
  更新完成后，Homebrew会拉取当前系统可兼容的最高版本软件包列表，10.15系统下与系统兼容的CocoaPods正式版本上限即为1.10.1，不会出现无法运行的更高版本。
• 清理旧版本CocoaPods残留文件
  此前安装的1.5.2版本如果存在路径残留，会导致新版本安装完成后，终端仍优先调用旧版本二进制。依次执行操作：
  brew uninstall cocoapods
  手动删除路径下的旧版本残留：/usr/local/bin/pod、/usr/local/lib/ruby/gems目录中关联1.5.2版本CocoaPods的相关文件，避免路径检索优先级错位。
• 指定版本完成安装
  绕过Homebrew本地缓存的旧包，直接指定目标兼容版本执行安装：
  brew install cocoapods@1.10.1
• 校验安装结果
  执行pod --version确认返回1.10.1版本。如果仍显示旧版本，检查终端配置的PATH环境变量，确保Homebrew二进制路径/usr/local/bin的检索优先级高于系统自带Ruby路径，避免调用非Homebrew渠道安装的旧版pod。

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