Mac上如何彻底移除CocoaPods？已安装但失效且常规卸载失败

一、排查CocoaPods的潜在安装位置 #

先通过以下命令定位可能的安装路径：

• 查找pod命令的实际位置：

  which pod
  

  输出会暴露pod的执行路径，比如用户Ruby版本管理器（rbenv/rvm）的shims目录、Homebrew的bin目录或系统Ruby的bin目录。

• 查看当前Ruby环境的gem安装目录：

  gem env
  

  重点关注INSTALLATION DIRECTORY字段，该目录下的gems/和specifications/文件夹可能存在CocoaPods残留。

• 检查Homebrew Formula安装的CocoaPods（区别于Cask）：

  brew list --formula | grep cocoapods
  

  若有输出，说明是通过Homebrew Formula而非Cask安装的。

• 检查系统Ruby的gem目录：
  Sonoma自带Ruby的默认gem路径为/Library/Ruby/Gems/2.6.0/，直接进入该目录查看是否有cocoapods-*开头的文件夹。

二、彻底移除CocoaPods的步骤 #

根据上述排查结果，执行对应清理操作：

1. 删除可执行命令文件
   基于which pod返回的路径，删除相关命令：

   sudo rm -f $(which pod)
   

   同时检查同目录下的pods、cocoapods、pod-setup等关联命令，一并删除。

2. 清理Ruby gem残留文件
   直接删除gem安装目录下的CocoaPods相关内容：

   # 替换为gem env输出的INSTALLATION DIRECTORY路径
   sudo rm -rf /Library/Ruby/Gems/2.6.0/gems/cocoapods-*
   sudo rm -rf /Library/Ruby/Gems/2.6.0/specifications/cocoapods-*.gemspec
   

   若使用rbenv/rvm，路径会是~/.rbenv/versions/[你的Ruby版本]/lib/ruby/gems/[版本号]/gems/，替换后执行同样的删除命令。

3. 清理Homebrew相关残留
   若通过Homebrew Formula安装，执行：

   brew uninstall --formula cocoapods
   brew cleanup cocoapods
   

4. 验证移除效果
   执行以下命令确认无残留：

   which pod  # 应返回"pod not found"
   gem list | grep cocoapods  # 无输出即为清理完成
   

三、重新安装CocoaPods（可选） #

为避免Ruby版本冲突，推荐使用Homebrew安装：

brew install cocoapods

若需使用指定Ruby版本，确保已切换到目标Ruby环境后执行：

gem install cocoapods

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