一、安装
安装命令：
sudo gem install cocoapods
这个需要访问墙外，若不能正常安装，请看下面介绍的换源流程。
步骤：
（1）移除自带源
$ gem sources --remove https://rubygems.org/
（移除原有的自带ruby源）
$ gem sources -a https://ruby.taobao.org/
（换用国内淘宝源，请注意是https，http已被弃用，当然，也有用ruby中国的源的，只需将链接改成：gems.ruby-china.com/ 即可，区别大家自己感受）
（2）换源
用下面的命令查看源是否更换
$ gem sources -l
显示：
*** CURRENT SOURCES ***https://ruby.taobao.org/
即更换成功
（3）安装
$ sudo gem install cocoapods
（4）查看版本
pod --version
查看版本，检查cocoapods是否安装成功，若显示版本号，则安装成功
二、使用
通过命令行工具进入到项目所在目录：
vim Podfile
进行编辑，以导入Masonry为例：
第1行：确认使用平台是在iOS 10.0以上使用
第3行：将这些第三方类库用在自己建立的项目上
第5行：导入的第三方库Masonry 1.1.0版本，当然，这句也可以写成
pod 'Masonry'
不知道导哪个版本可以这样写，但是个人建议最好写上版本号，也可以用命令
pod search Masonry
查看Masonry的版本
保存关闭Podfile文件，在命令行输入：
pod install
此时会下载第三方库到项目中。如果第三方类库有很多，可以在pod 'Masonry'下面写下其他类库的名称，如：
pod 'Masonry'
pod 'AFNetworking'
保存关闭install，第三方类库就会下载到项目的Pods文件夹中。到此，CocoaPods使用介绍完毕。
三、卸载
1、卸载命令：
$ sudo gem uninstall cocoapods
2、先查看本地安装过的cocopods相关东西，命令如下：
$ gem list --local | grep cocoapods
会显示如下：
cocoapods-core (0.39.0)
cocoapods-downloader (0.9.3)
cocoapods-plugins (0.4.2)
cocoapods-search (0.1.0)
cocoapods-stats (0.6.2)
cocoapods-trunk (0.6.4)
cocoapods-try (0.5.1)
3、逐个删除：
$ sudo gem uninstall cocoapods-core
四、常用命令
1、更新gem：
sudo gem update --system
2、删除gem源：
gem sources --remove [https://ruby.taobao.org/](https://ruby.taobao.org/)
3、修改gem源：
gem sources -a [https://gems.ruby-china.org](https://gems.ruby-china.org/)
4、查看gem源是否是最新的：
gem sources -l
5、升级cocoapods
sudo gem install cocoapods
或指定版本
sudo gem install cocoapods -v '版本号'
6、升级cocoapods到预览版：
sudo gem install -n /usr/local/bin cocoapods --pre
7、查看升级后的cocoapods版本：
pod --version
五、使用总结
- 第一步，创建项目；
- 第二步，创建Podfile文件；
- 第三步，填写第三方库信息到podfile文件并保存;
- 第四步，安装第三方库，退出，用xcworkspace文件打开，这步非常关键，而且只能用这个打开，不是以前的xcodeproj文件了，不然会提示第三方库找不到;
- 第五步，导入头文件，开始使用。
六、常见问题
问题一：
[!] Oh no, an error occurred.
It appears to have originated from your Podfile at line 1.
Search for existing github issues similar to yours:
https://github.com/CocoaPods/CocoaPods/search?q=%2FUsers%2Fhuaqiao%2FDesktop%2FUserCommand1%2FPodfile%3A1%3A+syntax+error%2C+unexpected+%27%3A%27%2C+expecting+end-of-input%0Aplatform+%3A+ios+%0A++++++++++%5E&type=Issues
If none exists, create a ticket, with the template displayed above, on:
https://github.com/CocoaPods/CocoaPods/issues/new
Be sure to first read the contributing guide for details on how to properly submit a ticket:
https://github.com/CocoaPods/CocoaPods/blob/master/CONTRIBUTING.md
看到第一句是不是很有喜感，解决方案： You need reinstall cocoapods: so
sudo gem uninstall cocoapods
sudo gem install cocoapods
pod setup
问题二：
Invalid `Podfile` file: [!] Unsupported options `{:exclusive=>true}`
for target 'CocoaPodsDemo'
这种一般是pod install别人的工程，解决办法是将：
target 'mySuperApp_Tests', :exclusive => true do
pod 'mySuperApp', :path => '../'end
改成：
target 'mySuperApp_Tests' do pod 'mySuperApp', :path => '../' end
问题三：
[!] Unable to add a source with url
`https://github.com/CocoaPods/Specs.git` named `master`.
解决办法：
cd ~/.cocoapods/repos
git clone https://github.com/CocoaPods/Specs.git master
还有一种报错是：
[!] Unable to add a source with url `https://github.com/CocoaPods/Specs.git` named `master-1`.
You can try adding it manually in `~/.cocoapods/repos` or via `pod repo add`.
解决办法：
sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer
可以通过：
cd ~/.cocoapods
du -sh *
命令来查看文件大小
问题四：无论是执行pod install还是pod update都卡在了Analyzing dependencies不动原因在于当执行以上两个命令的时候会升级CocoaPods的spec仓库，加一个参数可以省略这一步，然后速度就会提升不少。加参数的命令如下：
pod install --verbose --no-repo-update
pod update --verbose --no-repo-update
问题五：提示找不到头文件
1，找到TARGETS -> Build Settings -> SearchPaths -> User Header Search Paths 在后面的空白处双击 2， 点击 ‘+’号，添加一个新的键为${SRCROOT}，值设置为recursive
问题六：pod install和pod update这俩命令字面意思理解就行，一个安装，一个更新然后我们要说说Podfile.lock文件和Pods文件夹：
Podfile.lock ：这个文件是用来保存已经安装的Pods依赖库的版本。 Pods文件夹：这里边全是引用的三方类库。如果Podfile.lock文件丢失，你再使用pod install命令，并且Podfile中含有没有指定版本的类库，那你的类库就会下载最新的版本，有些比较活跃的三方项目更新很频繁，它们一旦更新方法名或者实现方式，你调用的代码就报错了，这是灾难性的。 特别需要注意：使用pod update会更新的你Podfile.lock文件到最新版本，它们一旦更新方法名或者实现方式，你调用的代码就报错了，所以请不要手残。 所以千万记住，无论是自己的项目，还是跑别人的源码，一定要用pod install，至于pod update，看你自己是不是要三方升级类库（我还是建议最好在Podfile中指定版本，想要升级，只需更改Podfile中的版本号，再pod install）。
问题七：
sudo gem sources -a https://ruby.taobao.org/
Error fetching https://ruby.taobao.org/:
server did not return a valid file (http://ruby.taobao.org/specs.4.8.gz)
这真的是无妄之灾啊，网上找了半天解决办法，试过https改http，也试过：
1. rvm pkg install openssl
2. rvm reinstall all --force
和
$ gem sources --remove https://rubygems.org/
$ gem sources -a https://ruby.taobao.org/
$ gem sources -l*** CURRENT SOURCES ***
最后问群友，群友说试试看，能不能打开这个网站，结果是公司网络权限问题，对于某宝是不能正常访问的，/气哭/气哭。
问题八：
在运行 “sudo gem install cocoapods” 的时候出现问题：
ERROR: While executing gem ... (Errno::EPERM)
Operation not permitted - /usr/bin/fuzzy_match（或者是- /usr/bin/xcodeproj之类的）
则可以改为：
sudo gem install -n /usr/local/bin cocoapods
【参考】
