mac上安装cocoapods的核心是先通过homebrew独立安装ruby并配置路径，再换用国内rubygems镜像，最后执行gem install cocoapods且无需sudo，验证pod --version成功后即可在项目根目录运行pod init和pod install。
Mac 上装 CocoaPods，核心不是直接装 pod，而是先理清 Ruby 环境。系统自带的 Ruby 不推荐用——版本旧、权限受限、gem 安装容易失败。真正稳定的做法是用 Homebrew 或 RVM 独立管理 Ruby，再装 CocoaPods。
Ruby 环境：优先用 Homebrew 安装
Homebrew 是最轻量、适配性最强的选择，尤其对 Apple Silicon（M1/M2/M3）和 Intel Mac 都友好。
- 先装 Homebrew：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 装完运行
brew install ruby，它会把 Ruby 装到/opt/homebrew/bin（M 系列）或/usr/local/bin（Intel） - 把路径加进 shell 配置文件（
~/.zshrc）：echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc（M 系列）
或echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc（Intel） - 执行
source ~/.zshrc，再用which ruby确认路径是否含/opt/homebrew或/usr/local，避免误用系统 Ruby
RubyGems 镜像必须换，否则卡死
默认源 rubygems.org 在国内访问极慢，常导致 gem install 超时或中断。
- 先删掉原源：
gem sources --remove https://rubygems.org/ - 添加国内镜像（推荐 Ruby China）：
gem sources -a https://gems.ruby-china.com/ - 检查是否生效：
gem sources -l，输出应只有一行https://gems.ruby-china.com/
CocoaPods 安装与验证
确保已切换到 Homebrew 安装的 Ruby 后，直接用 gem 安装，全程无需 sudo。
- 执行：
gem install cocoapods - 验证：
pod --version，有数字输出即成功 - 首次使用建议运行
pod setup（后台静默初始化仓库，不用等完成再操作）
在项目中启用 Podfile
这步必须在 Xcode 工程根目录下进行，不能在子文件夹里。
- 终端进入项目路径：
cd /path/to/YourApp.xcodeproj/..（注意是 .xcodeproj 所在目录，不是文件本身） - 初始化：
pod init，生成默认 Podfile - 用编辑器打开 Podfile，修改 target 名称（要和 Xcode 里的 Target 名完全一致），例如：
target 'MyApp' do<br> use_frameworks!<br> pod 'Alamofire', '~> 5.9'<br>end
- 保存后执行：
pod install，成功会生成MyApp.xcworkspace - 之后用
.xcworkspace文件打开项目，而不是.xcodeproj
