在Intel macos 12.7.6中安装cocoapos1.安装macports访问阿里云开源镜像站的 MacPorts 页面https://mirrors.aliyun.com/macports/macports-distfiles-MacPorts安装包下载-开源镜像站-阿里云下载MacPorts-2.12.6-12-Monterey.pkg下载后点击安装安装过程会比较慢。安装完成后配置文件位置在 /opt/local/etc/macports/sources.confMacPorts 的可执行文件通常位于/opt/local/bin和/opt/local/sbin执行更新端口树 sudo port selfupdate也会比较慢。2.安装ruby搜索可用的ruby版本 port list | grep ^ruby安装ruby34sudo port install ruby34设置默认的ruby版本sudo port select --set ruby ruby34刷新shell环境source ~/.zshrc # 如果使用的是 bash则执行source ~/.bash_profile3.安装cocoapodssudo gem install -n /usr/local/bin cocoapods 显示 Successfully installed cocoapods-1.17.0pod --version 显示 1.17.0CocoaPods 版本‌CocoaPods 最新版本是 1.17.0‌可通过官方 GitHub 发布页面查看更新详情 。‌‌‌ 版本信息与官方渠道‌最新版本‌1.17.0 于 2026 年 7 月发布是目前 GitHub 官方 releases 页面显示的最新稳定版本 。‌‌‌‌官方资源‌CocoaPods 官网https://cocoapods.org提供基础介绍与文档。GitHub 发布页https://github.com/CocoaPods/CocoaPods/releases可查看完整版本历史与更新日志。‌‌‌‌版本兼容性‌CocoaPods 1.17.0 需要 Ruby 2.7.4 或更高版本macOS 系统自带 Ruby 版本过低时需通过 Homebrew 或版本管理器升级 。‌‌‌配置 Podfile‌进入项目目录‌.xcodeproj同级的目录。‌初始化‌执行pod init会生成一个 Podfile。‌编辑 Podfile‌用编辑器打开按需添加依赖。几个关键点‌platform‌写的是最低部署版本要和项目实际支持版本一致写高了低版本设备直接跑不了。‌use_frameworks!‌用动态库方式集成。如果遇到和静态库的冲突可以写成use_frameworks! :linkage :static来强制静态链接。‌版本写法‌pod 库名永远拿最新版风险高pod 库名, 1.0.0锁死精确版本pod 库名, ~ 1.0允许 1.x 系列更新最常用。‌‌ 安装依赖执行安装前‌先彻底关闭 Xcode‌否则容易出问题。‌‌pod install首次执行可能卡在更新仓库国内环境可以用pod install --verbose --no-repo-update安装成功后项目目录里会多出.xcworkspace文件。‌之后都用它打开工程‌别再开原来的.xcodeproj。‌‌✅ 日常使用与更新‌添加新库‌编辑 Podfile 加一行再执行pod install。‌更新某个库‌pod update 库名。‌更新全部‌pod update或先pod repo update再更新。‌查找库‌pod search 库名搜不到时执行pod setup再删掉~/Library/Caches/CocoaPods/search_index.json重试。‌‌