本文长期更新！M系列芯片的机型也适用
前言：
在需要安装CocoaPods时，总会有各种烦人的问题导致安装失败，这里总结一下，供大家参考。
参考1：CocoaPods 执行install或者update卡住或者失败
CocoaPods简介：
CocoaPods是一个用Ruby写的、负责管理iOS项目中第三方开源库的工具，CocoaPods能让我们集中的、统一管理第三方开源库，为我们节省设置和更新第三方开源库的时间。
CocoaPods安装：下面会介绍两种安装方法，推荐使用第二种，先敲重点！！！
重点一：如果你有梯子，建议全程开启，这样你的整个安装体验会很丝滑。重点二：命令中间可能有空格看不出来，建议从文中直接复制粘贴执行；注意：一些未知原因，直接复制的命令在终端执行无效，那就需要手动输入
一、前置安装
以下三个程序建议提前安装，安装方法都很简单，这里不做介绍；
1、Xcode2、Command Line Tools for Xcode3、Homebrew
二、使用Homebrew安装CocoaPods
这是目前来说最简单的的一种方式，只需要在终端执行以下命令，它会自动检测并安装依赖资源。
brew install cocoapods
需要注意的是，使用这种方式安装后不会直接生效，需要按照终端中的提示进行路径设置，还是需要你认真看下安装日志的。还有一个问题是作者本人在使用过程中，经常遇到各种命令执行报错问题，具体原因一直未知，这里还是建议采用下面这种方式安装CocoaPods。
三、使用Ruby安装CocoaPods
这是最为常见的一种安装方式，安装过程稍加繁琐；照着做一般不会有问题；
1、查看当前Ruby版本
Mac电脑自带Ruby环境，但是安装CocoaPods需要2.2.2版本及以上的，查看当前Ruby版本
// 终端执行ruby-v// 执行结果如下：如果不是下面的版本，下面会演示如何安装ruby3.3.1(2024-04-23revision c56cd86388)[arm64-darwin23]
2、安装RVM
后面需要使用RVM来安装或者升级Ruby；分别执行下面三条命令：
curl -L get.rvm.io | bash -s stable source ~/.bashrcsource ~/.bash_profile
3、查看RVM版本
// 终端执行rvm-v// 结果如下rvm1.29.12(latest)byMichalPapis,PiotrKuczynski,WayneE.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.1 稳定版,下面安装会使用3.3.1进行示例（最新版可能会有一些兼容问题，例如一些插件并没有支持到最新版导致不能正常使用，这个遇到问题了再说吧）。
5、安装Ruby
终端执行：
rvm install 3.3.1 或 rvm install ruby-3.3.1
如果遇到如下报错,是因为新版中OPENSSL1.0版本已经被废弃，需要使用OPENSSL3.0
Error running'__rvm_make -j12'或者Error running'__rvm_make -j8'
这时候需要使用下面的命令进行安装：
brew install openssl@3rvm install ruby-3.3.1--with-openssl-dir='brew --prefix openssl'或者rvm install ruby-3.3.1--with-openssl-dir='brew --prefix openssl@3'
注意：安装过程中需要两次按下 Enter 键, 第二次按下后需要输入电脑访问密码(不可见,只管输入就行);
6、设置Ruby默认版本
如果你安装了多个Ruby就需要设置一下默认的版本
rvm use 3.3.1 --default
7、更新Gem和更换源
sudo gem update --system
///这一步建议是先执行后续用到了再添加///例如，你使用Fastlane进行自动化部署这个是需要的gem sources--removehttps://rubygems.org/
gem sources--addhttps://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.如果你开启了梯子gitclonehttps://github.com/CocoaPods/Specs.git ~/.cocoapods/repos/trunk
/// B.这是国内的镜像地址，不需要梯子，速度刚刚的，想省事的就直接选这个吧gitclonehttps://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git ~/.cocoapods/repos/trunk
上述命令执行完成之后的目录结构见下图,
如果不是就自己手动移动一下
Snip20191011_2.png
12、检验一下成果
pod search Alamofire/// 第一次比较慢，耐心等待按Q键退出搜索
13、CocoaPods的具体使用
新建一个Xcode工程，cd到工程根目录下
/// 创建Podfile文件：podinit
添加依赖库进行验证，如下
platform:ios,'13.0'inhibit_all_warnings!use_frameworks!target'DemoTarget'dopod'Alamofire'end
/// 安装pod install
Success！！！
作者：小海豚丶
链接：https://www.jianshu.com/p/f43b5964f582
来源：简书
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。
