1、檢查安裝 rvm 環境（ 正常情況可直接略過此步驟 ）

• 檢查當前 rvm 環境（ 此處檢查是否存在 rvm 環境 ）：

   $ rvm -v

  `輸出結果：（ 存在 rvm 環境）`
   muxuguixiandeMacBook-Pro:~ jijiucheng$ rvm -v
   rvm 1.29.1 (latest) by Wayne E. Seguin <[email protected]>, Michal Papis <[email protected]> [https://rvm.io/]

  `輸出結果：（不存在 rvm 環境）`
   muxuguixiandeMacBook-Pro:
   
  ~ jijiucheng$ rvm -v
   -bash: rvm: command not found

  
  情況一：如果不存在 rvm 環境，先安裝 配置 rvm 環境；

   ① 期間可能會問你 `sudo管理員` 密碼，以及自動通過 `homebrew` 安裝依賴包；
   等待一段時間後就可以成功安裝好 `rvm`。

  $ curl -L https://get.rvm.io | bash -s stable

   輸出結果：（下載安裝）（顯示的 `` 代表一行空格）
   muxuguixiandeMacBook-Pro:~ jijiucheng$ curl -L https://get.rvm.io | bash -s stable
   % Total    % Received % Xferd  Average Speed   Time    Time     Time                
   Current Dload  Upload   Total   Spent    Left  Speed
   100
   
     184  100   184    0     0     93      0  0:00:01  0:00:01 --:--:--    93
   100 22865  100 22865    0     0   8964      0  0:00:02  0:00:02 --:--:--  710k
   Downloading https://github.com/rvm/rvm/archive/1.27.0.tar.gz
   Downloading     
   https://github.com/rvm/rvm/releases/download/1.27.0/1.27.0.tar.gz.asc
   Found PGP signature at:   
   'https://github.com/rvm/rvm/releases/download/1.27.0/1.27.0.tar.gz.asc'
   
  ,
    but no GPG software exists to validate it, skipping.
     ``
   `Installing RVM to /Users/smalllufeinj/.rvm/`
     Adding rvm PATH line to /Users/smalllufeinj/.profile   
     /Users/smalllufeinj/.mkshrc /Users/smalllufeinj/.bashrc   
     /Users/smalllufeinj/.zshrc.
     Adding rvm loading line to /Users/smalllufeinj/.profile     
     /Users/smalllufeinj/.bash_profile /Users/smalllufeinj/.zlogin.
    `Installation of RVM in /Users/smalllufeinj/.rvm/ is almost complete:`
     ``
    .* To start using RVM you need to run `source     
     /Users/smalllufeinj/.rvm/scripts/rvm`
     in all your open shell windows, in rare cases you need to reopen all shell windows.
     ``
     # muxuguixian,
     #
     #   Thank you for using RVM!
     #   We sincerely hope that RVM helps to make your life easier and more enjoyable!!!
     #
     # ~Wayne, Michal & team.
     ``
     In case of problems: https://rvm.io/help and https://twitter.com/rvm_io

  ② 然後，載入 RVM 環境（新開 Termal 就不用這麼做了，會自動重新載入的）。

  $ source ~/.rvm/scripts/rvm

  輸出結果：（^_^）（什麼都沒有輸出）
  muxuguixiandeMacBook-Pro:~ jijiucheng$ source ~/.rvm/scripts/rvm

  ③ 再次檢查 rvm 是否安裝正確。

  $ rvm -v

   `輸出結果：（ 存在 rvm 環境）`
    muxuguixiandeMacBook-Pro:~ jijiucheng$ rvm -v
    rvm 1.29.0 (latest) by Wayne E. Seguin <[email protected]>,     
    Michal Papis <[email protected]> [https://rvm.io/]

情況二：如果存在 rvm 環境，用 rvm 安裝 ruby 環境；

• 當 ruby 版本低於 2.2.2 時，安裝 CocoaPods 會報錯；為防止 ruby 版本過低，建議先升級 ruby 環境，建議升級到 2.3.0 版本以上。【可以通過 $ ruby -v 指令檢查當前 ruby 版本】
  

  ① 查詢已知的 ruby 環境。

  $ rvm list known

  輸出結果：（顯示的 `` 代表一行空格）
  muxuguixiandeMacBook-Pro:~ jijiucheng$ 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[.8]
  [ruby-]2.2[.4]
  [ruby-]2.3[.0]
  [ruby-]2.2-head
  ruby-head
    ``
  # for forks use: rvm install ruby-head-<name> --url       
  https://github.com/github/ruby.git --branch 2.2
  ``
  # JRuby
  jruby-1.6[.8]
  jruby-1.7[.23]
  jruby[-9.0.5.0]
  jruby-head
  ``
  # Rubinius
  rbx-1[.4.3]
  rbx-2.3[.0]
  rbx-2.4[.1]
  rbx[-2.5.8]
  rbx-head
  ``
  # Opal
  opal
  ``
  # Minimalistic ruby implementation - ISO 30170:2012
  mruby[-head]
  ``
  # Ruby Enterprise Edition
  ree-1.8.6
  ree[-1.8.7][-2012.02]
  ``
  # GoRuby
  goruby
  ``
  # Topaz
  topaz
  ``
  # MagLev
  maglev[-head]
  maglev-1.0.0
  ``
  # Mac OS X Snow Leopard Or Newer
  macruby-0.10
  macruby-0.11
  macruby[-0.12]
  macruby-nightly
  macruby-head
  ``
  # IronRuby
  ironruby[-1.1.3]
  ironruby-head

  
  查詢已知的 ruby 環境

   ② 指定 ruby 版本進行更新（ 此處按照 ruby 2.4.0 版本進行更新 ）。

  $ rvm install 2.4.0

   輸出結果：（ 此處因為終端輸出的字元過多，所以此處用截圖方式 ）

  
  指定 ruby 版本進行更新

  ③ 第二步需要一段時間等待，完成後此時 rvm 環境就配置好了；Ruby Gems 就安裝好了。

  ④ 補充相關指令：
        查詢已安裝的 ruby：
                         $ rvm list
        解除安裝一個已安裝版本：
                          $ rvm remove 1.9.2

2、檢查更新 ruby 版本環境（正常情況下從此步驟開始）

• • CocoaPods 是用 gem ruby 實現的，要想使用它首先需要有 gem ruby 的環境。且 MAC 的 OS X系統預設已經可以執行 ruby 。

• • 此處建議 gem ruby 包環境升級到 2.6.x 以上。
    

    
    檢查 gem ruby 版本號:

        $ sudo gem -v

        檢查結果：（ 預設情況下版本應該較低，建議升級到 ）
        muxuguixiandeMacBook-Pro:local jijiucheng$ gem -v
        2.5.1

    
    更新 gem ruby 版本號：

        $ gem update --system

        更新成功：（ 實際列印可能與此不同，但是成功了就會顯示 Successfully ）
        muxuguixiandeMacBook-Pro:local jijiucheng$ gem update --system
        Updating rubygems-update
        Fetching: rubygems-update-2.6.7.gem (100%)
        Successfully installed rubygems-update-2.6.7

        此種提示：（ 表示已經是最新的 gem ruby 環境 ）
        muxuguixiandeMacBook-Pro:~ jijiucheng$ gem update --system
        Latest version currently installed. Aborting.

    檢查 ruby 源：
    

        $ gem sources -l

        檢查結果：（ 如果電腦沒安裝過 CocoaPods，此時應該是預設 ruby 源 ）
        muxuguixiandeMacBook-Pro:~ jijiucheng$ gem sources -l
        *** CURRENT SOURCES ***
        https://rubygems.org/

    移除 ruby 源:

        $ gem sources --remove https://rubygems.org/

         移除結果：
          muxuguixiandeMacBook-Pro:local jijiucheng$ gem sources --remove https://rubygems.org/
          https://rubygems.org/ removed from sources

    替換新增國內映象源 ruby-china 源，因為上面已經提到國內映象源 taobao 源 已經停止維護了，所以此處替換的是 ruby-china 源，且儘量確保只有一個 ruby-china 源。

      也可以，可以將 官方 ruby 源 替換成國內 淘寶 ruby（[https://ruby.taobao.org/](https://ruby.taobao.org/) ）

    $ gem sources --add https://gems.ruby-china.org

    替換結果：
    muxuguixiandeMacBook-Pro:local jijiucheng$ gem sources --add  https://gems.ruby-china.org
    https://gems.ruby-china.org added to sources

    再次檢查此時的 ruby 源：（ 已經變成了 ruby-china 源 ）
    muxuguixiandeMacBook-Pro:local jijiucheng$ gem sources -l
    *** CURRENT SOURCES ***
    https://gems.ruby-china.org

• 安裝 CocoaPods（ sudo 表示管理員執行指令 ）（此處需要輸入一次密碼 ）

      $ sudo gem install cocoapods

    `注意點：<------------------------------> 此處有個注意點`
     由於 OS X 系統的不同，此處的指令也是有些變化:
     OS X 10.11之前系統的安裝 CocoaPods 指令： $ sudo gem install cocoapods
     OS X 10.11以後系統的安裝 CocoaPods 指令： $ sudo gem install -n /usr/local/bin cocoa pods
     OS X 10.12 $ sudo gem install -n /usr/local/bin cocoa pods

  安裝結果：（正常情況列印沒有這麼多，此處是因為解決報錯時，同時列印了這麼多）
  muxuguixiandeMacBook-Pro:local jijiucheng$ sudo gem install cocoa pods
  Password:   <----------------------------------->  // 此處需要輸入一次密碼 
  Fetching: ffi-1.9.14.gem (100%)
  Building native extensions.  This could take a while...
  Successfully installed ffi-1.9.14
  Fetching: thread_safe-0.3.5.gem (100%)
  Successfully installed thread_safe-0.3.5
  Fetching: tzinfo-1.2.2.gem (100%)
  Successfully installed tzinfo-1.2.2
  Fetching: i18n-0.7.0.gem (100%)
  Successfully installed i18n-0.7.0
  Fetching: concurrent-ruby-1.0.2.gem (100%)
  Successfully installed concurrent-ruby-1.0.2
  Fetching: activesupport-5.0.0.1.gem (100%)
  Successfully installed activesupport-5.0.0.1
  Fetching: cocoa-0.1.6.gem (100%)
  Successfully installed cocoa-0.1.6
  Parsing documentation for ffi-1.9.14
  Installing ri documentation for ffi-1.9.14
  Parsing documentation for thread_safe-0.3.5
  Installing ri documentation for thread_safe-0.3.5
  Parsing documentation for tzinfo-1.2.2
  Installing ri documentation for tzinfo-1.2.2
  Parsing documentation for i18n-0.7.0
  Installing ri documentation for i18n-0.7.0
  Parsing documentation for concurrent-ruby-1.0.2
  Installing ri documentation for concurrent-ruby-1.0.2
  Parsing documentation for activesupport-5.0.0.1
  Installing ri documentation for activesupport-5.0.0.1
  Parsing documentation for cocoa-0.1.6
  Installing ri documentation for cocoa-0.1.6
  Done installing documentation for ffi, thread_safe, tzinfo, i18n, concurrent-ruby, activesupport, cocoa after 34 seconds
  Fetching: pods-0.0.1.gem (100%)
  Successfully installed pods-0.0.1
  Parsing documentation for pods-0.0.1
  Installing ri documentation for pods-0.0.1
  Done installing documentation for pods after 0 seconds
  8 gems installed
  <------------------ 此處有 gems installed 標誌著安裝 CocoaPods 成功 ------------------>

  
  安裝 CocoaPods
  • 正常情況下此處會出現很大的坑，經常會出現各種報錯問題，大多數是為 ruby 環境過低沒有更新升級，或者是牽扯到 rvm 管理器環境的問題，在後面各種報錯問題的解決方案的中會有提到。