无法更新Cocoapods至最新版本，提示需安装开发工具问题求助

问题背景 #

本地安装的1.8.4版本Cocoapods无法升级，无法满足FirebaseAnalytics最低1.10.0的版本要求，升级过程中出现开发工具未安装、brew安装后版本仍为旧版等问题。

解决方案 #

1. 解决gem安装时报「需要先安装开发工具」错误 #

即使已经安装Xcode命令行工具，仍出现该报错一般为命令行工具路径配置错误，按以下步骤处理：

• 检查当前命令行工具路径：
  xcode-select -p
• 如果输出路径不为/Applications/Xcode.app/Contents/Developer，执行以下命令切换：
  sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
• 切换完成后执行以下命令同意Xcode许可协议：
  xcodebuild -license accept
• 若配置路径后仍报错，可重装命令行工具：

  sudo rm -rf /Library/Developer/CommandLineTools
  xcode-select --install
  

2. 解决brew安装升级后版本仍为旧版问题 #

该问题由PATH路径优先级导致，系统自带或旧版本gem安装的Cocoapods路径优先级高于brew安装路径，按以下步骤修复：

• 查看当前PATH路径顺序：
  echo $PATH
• 编辑终端配置文件（zsh用户编辑~/.zshrc，bash用户编辑~/.bash_profile），在文件末尾添加对应芯片的路径配置：
  • Intel芯片Mac：export PATH="/usr/local/bin:$PATH"
  • Apple Silicon芯片Mac：export PATH="/opt/homebrew/bin:$PATH"
• 执行配置生效命令：
  source ~/.zshrc（zsh用户）或source ~/.bash_profile（bash用户）
• 执行pod --version验证版本是否正确。

3. 项目级版本兼容方案 #

如果需要避免全局Cocoapods版本影响多个项目，可使用bundle进行依赖管理：

• 在项目根目录的Gemfile中指定Cocoapods版本：
  gem 'cocoapods', '~> 1.11.2'
• 执行bundle install安装对应版本
• 项目内执行pod相关命令时添加bundle exec前缀即可调用指定版本，例如bundle exec pod install。

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