本文长期更新！M系列芯片的机型也适用
Xcode16 pod init等命令执行出错的请参考点击这里这里这里这里;或者更新到Cocoapods最新版已修复该问题。
前言：
在需要安装CocoaPods时，总会有各种烦人的问题导致安装失败，这里总结一下，供大家参考。
参考1：CocoaPods 执行install或者update卡住或者失败
参考2：给Terminal终端命令行配置网络代理的方法
CocoaPods简介：
CocoaPods是一个用Ruby写的、负责管理iOS项目中第三方开源库的工具，CocoaPods能让我们集中的、统一管理第三方开源库，为我们节省设置和更新第三方开源库的时间。
CocoaPods安装：下面会介绍两种安装方法，推荐使用第二种，先敲重点！！！
重点一：如果你有梯子，建议全程开启，这样你的整个安装体验会很丝滑。
重点二：命令中间可能有空格看不出来，建议从文中直接复制粘贴执行；
注意：一些未知原因，直接复制的命令在终端执行无效，那就需要手动输入
一、前置安装
以下三个程序建议提前安装，安装方法都很简单，这里不做介绍；
1、Xcode
2、Command Line Tools for Xcode
3、Homebrew
二、使用Homebrew安装CocoaPods（建议建议建议，简单快捷，一行命令完事）
这是目前来说最简单的的一种方式，只需要在终端执行以下命令，它会自动检测并安装依赖资源。
brew install cocoapods
需要注意的是，使用这种方式安装后不会直接生效，需要按照终端中的提示进行路径设置，还是需要你认真看下安装日志的。还有一个问题是作者本人在使用过程中，经常遇到各种命令执行报错问题，具体原因一直未知，这里还是建议采用下面这种方式安装CocoaPods。
三、使用Ruby安装CocoaPods
这是最为常见的一种安装方式，安装过程稍加繁琐；照着做一般不会有问题；
1、查看当前Ruby版本
Mac电脑自带Ruby环境，但是安装CocoaPods需要2.2.2版本及以上的，查看当前Ruby版本
// 终端执行
ruby -v
// 执行结果如下：如果不是下面的版本，下面会演示如何安装
ruby 3.3.6 (2024-11-05 revision 75015d4c1f) [arm64-darwin24]
2、安装RVM
后面需要使用RVM来安装或者升级Ruby；分别执行下面三条命令：
curl -L get.rvm.io | bash -s stable
source ~/.bashrc
source ~/.bash_profile
3、查看RVM版本
// 终端执行
rvm -v
// 结果如下
rvm 1.29.12 (latest) by Michal Papis, Piotr Kuczynski, Wayne E. Seguin [https://rvm.io]
4、查看可用安装
// 终端执行
rvm list known
结果如下：
# MRI Rubies
[ruby-]1.8.6[-p420]
[ruby-]1.8.7[-head] # security released on head
[ruby-]1.9.1[-p431]
[ruby-]1.9.2[-p330]
[ruby-]1.9.3[-p551]
[ruby-]2.0.0[-p648]
[ruby-]2.1[.10]
[ruby-]2.2[.10]
[ruby-]2.3[.8]
[ruby-]2.4[.10]
[ruby-]2.5[.8]
[ruby-]2.6[.6]
[ruby-]2.7[.2]
[ruby-]3[.0.0]
ruby-head
.....
以下省略
上面显示的最新版本是ruby-3.0.0，但是截止到标题日期最新版是3.3.6 稳定版,下面安装会使用3.3.6进行示例（最新版可能会有一些兼容问题，例如一些插件并没有支持到最新版导致不能正常使用，这个遇到问题了再说吧）。
5、安装Ruby
终端执行：
rvm install 3.3.6
或
rvm install ruby-3.3.6
如果遇到如下报错,是因为新版中OPENSSL1.0版本已经被废弃，需要使用OPENSSL3.0
Error running '__rvm_make -j12'
或者
Error running '__rvm_make -j8'
这时候需要使用下面的命令进行安装：
brew install openssl@3
rvm install ruby-3.3.6 --with-openssl-dir='brew --prefix openssl'
或者
rvm install ruby-3.3.6 --with-openssl-dir='brew --prefix openssl@3'
注意：安装过程中需要两次按下 Enter 键, 第二次按下后需要输入电脑访问密码(不可见,只管输入就行);
部分电脑上使用rvm的方式安装依旧会要求使用openssl1.1，目前官方已经结束了1.1版本的支持，这个自行处理吧。
6、设置Ruby默认版本
如果你安装了多个Ruby就需要设置一下默认的版本
rvm use 3.3.6 --default
7、更新Gem和更换源
sudo gem update --system
///这一步建议是先执行后续用到了再添加
///例如，你使用Fastlane进行自动化部署这个是需要的
gem sources --remove https://rubygems.org/
gem sources --add https://gems.ruby-china.com/
8、验证你的Ruby镜像是并且仅是ruby-china
gem sources -l
如果是以下结果说明正确，如果有其他的请自行百度解决
*** CURRENT SOURCES ***
https://gems.ruby-china.com/
9、安装CocoaPods，以下二选一
第一种：（推荐）
sudo gem install -n /usr/local/bin cocoapods
10、如果安装了多个Xcode使用下面的命令选择（一般需要选择最近的Xcode版本）
sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer
11、安装本地库，这个内容有点多，建议先看完在操作
说明：该步骤是安装本地库，不安装也没事，项目可以照常pod install，只不过pod search 命令用不了；如果你追求完美那就继续往下看；
A、第一种（官方的方法，已失效）
pod setup/// 这个是官方提供的安装方法，不过现在已失效
B、第二种（推荐）
/// A.如果你开启了梯子
git clone https://github.com/CocoaPods/Specs.git ~/.cocoapods/repos/trunk
/// B.这是国内的镜像地址，不需要梯子，速度刚刚的，想省事的就直接选这个吧
git clone https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git ~/.cocoapods/repos/trunk
上述命令执行完成之后的目录结构见下图,
如果不是就自己手动移动一下
12、检验一下成果
pod search Alamofire /// 第一次比较慢，耐心等待
按Q键退出搜索
13、CocoaPods的具体使用
新建一个Xcode工程，cd到工程根目录下
/// 创建Podfile文件：
pod init
添加依赖库进行验证，如下
platform :ios, '13.0'
inhibit_all_warnings!
use_frameworks!
target 'DemoTarget' do
pod 'Alamofire'
end
/// 安装
pod install
