核心是用Homebrew安装独立Ruby、换清华镜像源、写规范Podfile并按需执行命令：brew install ruby→配置PATH→gem install cocoapods→pod repo remove trunk && pod repo add trunk https://mirrors.tuna.tsinghua.edu.cn/cocoapods-specs.git→声明platform和swift_version→用pod install而非盲目update。
在 macos 上用 cocoapods 管理 ios 项目依赖，核心是让环境稳、配置准、操作轻。不是装得越快越好，而是每次 pod install 都能可靠执行、不报错、不卡住、不升级不该升的库。
装对 Ruby，避开系统自带版本
macOS 自带的 Ruby 受 SIP 保护，且版本老旧，gem install cocoapods 容易因权限或兼容性失败。正确做法是：
- 用 Homebrew 安装独立 Ruby：
brew install ruby - 把 Homebrew 的 bin 路径加进 shell 配置（如
~/.zshrc）：export PATH="/opt/homebrew/bin:$PATH"（Apple Silicon）或export PATH="/usr/local/bin:$PATH"（Intel） - 重载配置：
source ~/.zshrc，再运行which ruby，确认路径含/opt/homebrew或/usr/local - 然后执行
gem install cocoapods（不加sudo）
换国内镜像源，解决卡在 Updating local specs repositories
默认的 https://cdn.cocoapods.org 在国内访问慢甚至超时，导致 pod install 卡死。只需两步切换到清华镜像：
- 清理旧源：
pod repo remove trunk - 添加新源：
pod repo add trunk https://mirrors.tuna.tsinghua.edu.cn/cocoapods-specs.git - 验证是否生效：
pod repo list，看到trunk指向清华地址即成功
写干净的 Podfile，减少冲突和重复解析
一个清晰的 Podfile 能让依赖管理更可控、更可维护：
- 平台和 Swift 版本声明放在最外层，不要嵌套在每个 target 里：
platform :ios, '13.0'和swift_version = '5.9' -
use_frameworks!写一次即可，无需在每个 target 中重复 - 第三方库优先用版本号约束：
pod 'Alamofire', '~> 5.9'，避免直接写:git =>除非必须跟踪分支 - 私有库用
:path => '../MySDK'时，确保路径真实存在、不含空格或中文
按需执行命令，不盲目更新
日常开发中，90% 的场景只需要 pod install。其他操作要有明确目的：
- 只更新个别库？用
pod update Alamofire Kingfisher，而不是全量pod update - 想跳过远程 spec 更新（比如网络差或只想本地重装）？加
--no-repo-update参数：pod install --no-repo-update - CI/CD 环境建议加
--deployment，它会严格校验Podfile.lock，版本不符直接失败，更安全 - 清缓存别手动删
~/Library/Caches/CocoaPods，用pod cache clean --all更稳妥
