Hey there, let's work through this pod install error you're facing in your Xcode environment. Based on the details you shared, here's a structured approach to diagnose and fix the issue:

你的环境信息 #

• CocoaPods : 1.4.0
• Ruby : ruby 2.0.0p648 (2015-12-16 revision 53162) [universal.x86_64-darwin16]
• RubyGems : 2.0.14.1
• 主机系统 : Mac OS X 10.12.6 (16G29)
• Xcode : 7.3.1 (7D1014)
• Git : git version 2.7.4 (Apple Git-66)
• Ruby库目录 : /System/Library/Frameworks/Ruby.framework/Versions/2.0/usr/lib

分步排查与修复步骤 #

1. 升级老旧的依赖组件 #

Your CocoaPods (1.4.0) and RubyGems (2.0.14.1) versions are pretty outdated—this is a common source of installation bugs. Let's update them first:

# 先升级RubyGems到兼容版本
sudo gem update --system
# 安装适配你系统的稳定版CocoaPods（1.11.3 适配Mac 10.12和Ruby 2.0.0）
sudo gem install cocoapods -v 1.11.3

如果遇到权限问题，用--user-install参数避免系统级冲突：

gem install cocoapods -v 1.11.3 --user-install

2. 清理CocoaPods缓存与项目残留 #

损坏的缓存或残留文件经常会导致pod install失败，执行以下命令重置环境：

# 清理所有本地pod缓存
pod cache clean --all
# 删除项目中的Podfile.lock和Pods目录
rm -rf Podfile.lock Pods/
# 完全解除pod与项目的关联
pod deintegrate
# 重新初始化CocoaPods仓库
pod setup

完成后再尝试运行pod install。

3. 确认Xcode命令行工具匹配 #

确保命令行工具与你的Xcode 7.3.1版本一致：

• 打开Xcode → 偏好设置 → 位置
• 在命令行工具选项中选择Xcode 7.3.1
  也可以在终端执行：

xcode-select -s /Applications/Xcode.app/Contents/Developer

4. 解决系统Ruby的局限性 #

系统自带的Ruby 2.0.0版本过旧，容易引发依赖冲突。如果上面的步骤都无效，可以用版本管理器rbenv安装一个独立的较新Ruby版本：

# 先安装Homebrew（如果还没装）
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
# 安装rbenv
brew install rbenv
# 初始化rbenv到shell配置
echo 'eval "$(rbenv init -)"' >> ~/.bash_profile
source ~/.bash_profile
# 安装Ruby 2.6.10（兼容Mac 10.12和新版CocoaPods）
rbenv install 2.6.10
# 设置全局Ruby版本
rbenv global 2.6.10
# 重新安装CocoaPods
gem install cocoapods

5. 检查Podfile配置 #

仔细检查你的Podfile是否存在常见错误：

• pod名称或版本号没有拼写错误
• 没有引入要求Xcode版本高于7.3.1的库（部分第三方库已不再支持旧版Xcode）
• 确认源地址正确：source 'https://cdn.cocoapods.org/'

如果执行完这些步骤仍然有问题，把pod install输出中的具体错误信息（通常是红色提示部分）贴出来，这样能更精准定位问题。

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