AFNetworking 等常見庫都支援 CocoaPods,用 pod 指令整合第三方套件本該輕鬆省事。但當鏡像來源失效時,pod install 就會卡住不動或直接失敗。本文記錄一次因 taobao 鏡像下線而導致 CocoaPods 無法使用的排查與修復過程。
如果你執行下面任一指令都遲遲無法完成:
pod install --verbose --no-repo-update pod update --verbose --no-repo-update
那麼很可能就是 gem 來源(source)出了問題,而非專案設定有誤。
1. 移除舊的來源網址
gem sources --remove https://rubygems.org/
2. 加入新的鏡像網址
gem sources -a https://gems.ruby-china.org/
3. 確認目前生效的來源清單
gem sources -l
執行後應能看到只剩新的鏡像網址,代表切換成功。
4. 重新安裝 CocoaPods
sudo gem install -n /usr/local/bin cocoapods
如果你最近升級過 macOS,這個步驟是必要的。系統版本更新後,原本安裝在舊路徑的可執行檔可能已失效,需要重新安裝一次。這裡的 -n 參數用來指定二進位檔的安裝位置,避免 Apple Silicon 或新版系統下的路徑問題。
5. 更新第三方庫資料
pod update --verbose --no-repo-update
--no-repo-update?它會跳過更新本地的 spec repo,速度大幅提升。若你確定本地 repo 已經是最新的,加上這個參數能省下大量等待時間。gem install 出現權限錯誤,除了 sudo,也可以考慮用 rbenv 或 RVM 管理 Ruby 版本,從根本避免系統 Ruby 的權限限制。整體流程就是:確認來源 → 換掉失效的鏡像 → 重裝 CocoaPods → 重新更新依賴。走完這四步,pod 相關指令通常就能恢復正常。