CocoaPods是iOS开发中最常用的第三方库依赖管理工具，需通过Homebrew安装Ruby再用gem安装CocoaPods，接着在项目根目录执行pod init和pod install生成.xcworkspace并以此打开项目。
如果您在开发iOS应用时需要引入第三方库，CocoaPods是Apple平台最常用的依赖管理工具。以下是Mac上安装和使用CocoaPods管理iOS项目依赖的具体步骤：
一、安装Homebrew（如尚未安装）
Homebrew是macOS上的包管理器，用于简化命令行工具的安装。CocoaPods依赖Ruby环境，而Homebrew能帮助我们更稳定地管理Ruby及相关依赖。
1、打开“终端”应用。
2、执行以下命令安装Homebrew：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
3、安装完成后，运行brew --version验证是否成功输出版本号。
二、安装或升级Ruby（推荐使用系统外版本）
macOS内置Ruby版本较旧且受系统保护，直接使用可能导致权限错误或gem安装失败。建议通过Homebrew安装最新稳定版Ruby。
1、在终端中执行：brew install ruby
2、将Homebrew安装的Ruby路径加入shell配置文件（如.zshrc）：echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc（Apple Silicon Mac）或echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc（Intel Mac）
3、重新加载配置：source ~/.zshrc
4、验证Ruby版本：ruby -v，确保输出为3.0以上版本。
三、安装CocoaPods
CocoaPods以Ruby gem形式分发，需通过gem命令安装。使用非系统Ruby可避免sudo权限问题及系统完整性保护（SIP）限制。
1、执行安装命令：gem install cocoapods
2、若提示权限错误，请勿加sudo；应确认已正确切换至Homebrew Ruby（通过which ruby检查路径是否含/opt/homebrew或/usr/local）。
3、安装完成后验证：pod --version，输出版本号即表示成功。
四、在iOS项目中初始化并使用Podfile
Podfile是CocoaPods的核心配置文件，定义项目所依赖的第三方库及其版本约束。必须在Xcode项目根目录下创建并配置该文件。
1、进入iOS项目所在目录：cd /path/to/your/xcode/project
2、执行初始化命令：pod init，生成默认Podfile。
3、用文本编辑器打开Podfile，修改target区块，例如：
target 'YourApp' do
use_frameworks!
pod 'AFNetworking', '~> 4.0'
end
4、保存后，在同一目录执行：pod install，CocoaPods将下载依赖、生成.xcworkspace并配置链接关系。
五、打开并构建项目
执行pod install后，原始.xcodeproj不再被直接使用，必须通过生成的.xcworkspace打开项目，否则依赖无法被识别和编译。
1、关闭当前Xcode窗口（如有打开）。
2、双击项目目录下的YourApp.xcworkspace文件（注意后缀名不是.xcodeproj）。
3、在Xcode中选择正确的Team和Signing证书，确保Build Settings中Always Embed Swift Standard Libraries设为Yes（若使用Swift库）。
4、点击运行按钮构建项目，验证第三方库是否可正常导入与调用，例如在ViewController中写入import AFNetworking并编译通过。
