完整報錯通常是:
ERROR: While executing gem ... (Errno::EPERM) Operation not permitted - /usr/bin/pod
這是 macOS 升級到 OS X El Capitan 之後出現的問題,根源是新系統的 SIP(System Integrity Protection)保護了 /usr/bin 目錄。把安裝命令改為指定其他安裝路徑即可:
sudo gem install -n /usr/local/bin cocoapods
報錯如下:
[!] Could not automatically select an Xcode workspace. Specify one in your Podfile like so: workspace 'path/to/Workspace.xcworkspace'
這個問題比較折磨人。解法是在 Podfile 中補上 target 與 platform 聲明,順序照抄即可,只把項目名改成自己的:
target "你的項目名稱" do
platform :ios, '7.0'
end
若換了安裝路徑仍失敗,可以依次嘗試:用 gem sources -l 檢查源是否可用並換成國內鏡像;用 sudo gem install -n /usr/local/bin cocoapods --verbose 查看具體失敗在哪一步;或者直接改用 Homebrew 安裝。此外 Target 名稱必須與 .xcodeproj 中的 target 完全一致,大小寫敏感,這是 workspace 匹配失敗最常見的原因。