已成功安装CocoaPods却提示‘command not found: pod’，如何解决？

1. 确认gem安装路径是否在系统PATH中 #

CocoaPods通过gem安装后，pod命令的可执行文件存放在gem安装目录下的bin文件夹内，需先定位该路径并检查是否被加入系统PATH：

• 执行以下命令查看gem的安装目录：

  gem environment
  

  在输出里找到INSTALLATION DIRECTORY，示例路径如/Users/[你的用户名]/.gem/ruby/[Ruby版本号]/bin或/usr/local/lib/ruby/gems/[Ruby版本号]/bin
• 检查当前系统PATH是否包含该路径：

  echo $PATH
  

• 若未找到该路径，将其添加到shell配置文件中（zsh用~/.zshrc，bash用~/.bash_profile）：
  打开配置文件：

  open ~/.zshrc
  

  添加一行（替换为你实际的gem bin路径）：

  export PATH="/Users/[你的用户名]/.gem/ruby/[Ruby版本号]/bin:$PATH"
  

  保存后执行以下命令使配置生效：

  source ~/.zshrc
  

  之后再尝试执行pod setup

2. 直接指定pod命令的绝对路径执行 #

若确认PATH配置正确但仍找不到命令，可直接用pod的绝对路径执行：

• 先定位pod的安装位置：

  gem which cocoapods
  

  输出路径类似/Users/[你的用户名]/.gem/ruby/[Ruby版本号]/gems/cocoapods-1.12.1/lib/cocoapods.rb，去掉末尾的lib/cocoapods.rb，替换为bin/pod就是pod命令的绝对路径
• 直接执行该路径下的pod：

  /Users/[你的用户名]/.gem/ruby/[Ruby版本号]/bin/pod setup
  

  若能正常执行，说明问题仍出在PATH配置，回到第一步修正即可

3. 改用Homebrew安装CocoaPods #

如果gem安装方式始终存在问题，可尝试用Homebrew安装（Homebrew会自动处理PATH配置）：

• 先卸载gem安装的CocoaPods：

  sudo gem uninstall cocoapods
  

• 用Homebrew安装：

  brew install cocoapods
  

• 安装完成后直接执行pod setup即可

4. 检查Ruby版本管理工具的影响 #

如果使用rbenv、rvm等Ruby版本管理工具，可能存在版本不匹配问题：

• 查看当前使用的Ruby版本：

  ruby -v
  

• 检查该Ruby版本下是否安装了CocoaPods：

  gem list cocoapods
  

• 若未找到，在当前Ruby版本下重新安装：

  gem install cocoapods
  

• 同时确保Ruby版本管理工具的初始化代码在shell配置文件中，比如rbenv需在~/.zshrc中添加：

  export PATH="$HOME/.rbenv/bin:$PATH"
  eval "$(rbenv init - zsh)"
  

  保存后执行source ~/.zshrc使配置生效

内容的提问来源于stack exchange，提问作者Chen Li Yong