黑蘋果安裝 CocoaPods 失敗：網絡限制、Ruby 環境與鏡像源配置完整解決方案

現象描述

黑蘋果（Hackintosh）上按教程安裝 CocoaPods 執行 `pod install` 卡住/報錯，Xcode 內無相關內容。

核心原因排查

分步解決方案

1. 更換 Ruby 源（關鍵）

gem sources --remove https://rubygems.org/
gem sources --add https://gems.ruby-china.com/
gem sources -l
# 輸出應僅含 ruby-china

2. 安裝 CocoaPods（用戶級，免 sudo）

gem install cocoapods --user-install
# 輸出提示路徑類似：/Users/xxx/.gem/ruby/3.0.0/bin
# 將該路徑加入 PATH
echo 'export PATH="$HOME/.gem/ruby/3.0.0/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

3. 配置 Specs 鏡像源

# 移除官方源
pod repo remove master
# 添加清華/阿里雲鏡像
pod repo add master https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git
# 或
pod repo add master https://mirrors.aliyun.com/git/CocoaPods/Specs.git
# 更新索引
pod repo update

4. Podfile 指定源

# Podfile 頭部
source 'https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git'
# source 'https://mirrors.aliyun.com/git/CocoaPods/Specs.git'

platform :ios, '13.0'
target 'MyApp' do
  pod 'AFNetworking'
end

5. 執行安裝

cd /path/to/project
pod install --verbose
# 成功輸出：Pod installation complete! There are X dependencies...

黑蘋果特有注意事項

• ✅ 確保系統時間正確（影響 SSL 證書驗證）
• ✅ 關閉代理/VPN 嘗試（部分代理干擾 git/https）
• ✅ 使用 `pod install --repo-update` 強制更新本地索引
• ✅ 若 Xcode Command Line Tools 缺失：`xcode-select --install`

常見報錯對照表

總結

黑蘋果裝 CocoaPods 核心是**換源（RubyGems + Specs）+ 用戶級安裝 + 代理配置**。按上述步驟操作，99% 能解決「裝不上、卡住、Xcode 空白」問題。