[iOS] CocoaPods 速查表
发布: (2026年2月6日 GMT+8 10:37)
2 分钟阅读
原文: Dev.to
Source: Dev.to
介绍
CocoaPods 是 iOS 项目的依赖管理工具。
安装
brew install ruby
sudo gem install cocoapods验证安装：
pod --version初始化 Podfile
进入包含 .xcodeproj 的文件夹并运行：
pod init编辑生成的 Podfile（Ruby DSL），指定平台、目标以及所需的 pod：
platform :ios, '15.0'
target 'YourAppTarget' do
use_frameworks!
pod 'Alamofire'
pod 'SnapKit'
end安装 Pods
pod install🚨 从现在起，打开
.xcworkspace文件，而不是.xcodeproj。
示例用法
import Alamofire
AF.request("https://example.com").response { response in
print(response)
}如果代码能够编译，说明已全部配置好。
常用 CocoaPods 命令
| 命令 | 描述 |
|---|---|
pod install | 安装 Podfile 中列出的依赖。 |
pod update | 将已安装的依赖更新到最新的兼容版本。 |
pod repo update | 刷新本地 specs 仓库。 |
pod deintegrate | 完全从项目中移除 CocoaPods。 |
pod search NAME | 按名称搜索 pod。 |
故障排除
-
“No such module” 或 构建设置冲突
pod deintegrate pod install -
安装慢
pod install --repo-update
何时使用 CocoaPods
- 已经依赖 CocoaPods 的旧项目。
- 尚未支持 Swift Package Manager（SPM）的库。
对于新项目，建议改用 Swift Package Manager。