macOS执行sudo gem install cocoapods安装CocoaPods失败报错

问题根因 #

报错日志中明确提示You have to install development tools first，本质是编译CocoaPods依赖的ffi原生扩展时，缺少Xcode命令行工具，或是工具未正确激活、许可协议未同意。

解决步骤 #

• 安装Xcode命令行工具
  终端执行命令：
  xcode-select --install
  弹出安装窗口后按照指引完成安装，全程需要5-10分钟，取决于网络速度。
• 验证并切换命令行工具路径
  执行命令查看当前工具路径：
  xcode-select -p
  若返回结果为/Applications/Xcode.app/Contents/Developer，执行以下命令切换为独立命令行工具路径：
  sudo xcode-select --switch /Library/Developer/CommandLineTools
• 同意Xcode许可协议
  执行命令：
  sudo xcodebuild -license accept
  输入开机密码确认即可。
• 重新安装CocoaPods
  执行官方安装命令：
  sudo gem install cocoapods
  若仍然报ffi相关错误，先单独安装ffi组件：
  sudo gem install ffi -- --enable-system-libffi
  安装完成后再执行CocoaPods安装命令即可。
• Apple Silicon芯片Mac可选方案
  若上述步骤仍未解决，可通过Homebrew直接安装，规避Ruby环境问题：
  brew install cocoapods

内容的提问来源于stack exchange，提问作者zendevil.eth