最近需要在自己的 mbp 上用 gem 装俩东西, 然后平了俩坑. 记一下, 作为以后遇到同样问题的记录.

首先是 Connection Reseted 的问题. 症状很简单, 用 gem install 后, 效果如下:

gem install xxx
ERROR:  While executing gem ... (Gem::RemoteFetcher::FetchError)
    Errno::ECONNRESET: Connection reset by peer - SSL_connect (https://api.rubygems.org/quick/Marshal.4.8/xxx.gemspec.rz)

原因很简单, 在中国 api.rubygems.org 是被墙的, 也不知是什么仇什么怨.

最简单的方法是用淘宝镜像.

淘宝镜像地址是: https://ruby.taobao.org/

淘宝镜像首页说明写得很详细.

淘宝不再维护了。按照重定向,目前可以使用 Ruby China 的。不过按照这尿性....

若是直接用 gem 手工安装的话, 用如下命令即可搞定:

$ gem sources --add https://gems.ruby-china.com --remove https://rubygems.org/
$ gem sources -l
*** CURRENT SOURCES ***

https://gems.ruby-china.com
# 请确保只有 gems.ruby-china.com
# 若发现还有 ruby.taobao.org,可以再删除下:
# $ gem sources --remove https://ruby.taobao.org
$ gem install xxx

它其实就是修改了下你的 ~/.gemrc 文件

若用 bundle , 则可以使用命令

bundle config mirror.https://rubygems.org https://gems.ruby-china.com

在 OS X 下, 若继续 gem install, 那么很容易遇到一个权限类报错,内容如下:

gem install xxx
1 gem installed
gem install xxx
ERROR:  While executing gem ... (Gem::FilePermissionError)
    You don't have write permissions for the /Library/Ruby/Gems/2.0.0 directory.

原因即字面意思, 就是 gem 要往某个神奇的目录写文件但是你的权限不够. 因为你使用的是 Apple 家自带的 ruby, 在尝试往 Apple 自家的库中塞东西, 默认那个位置是给 root 的.

有两个差劲的方法可以解决这个问题. 一个是前面加 sudo. 这时候记得先用 sudo 重走第一步换个源. 另一种是修改 /Library/Ruby/Gems/2.0.0 这个目录的用户, 即

sudo chown -R $(whoami) /Library/Ruby/Gems/2.0.0

随着版本升级, apple 的系统库也会有所改变。比如 10.14.2 版本的 ruby 是 2.3.0. 这个以此类推即可。

总之就是强行让我们可以写那个目录。但问题是那个库是系统运行时候所用的,要是弄乱了很不好收拾。

个人最建议的是用 homebrew 再装一个 ruby, 这样 local 归 local, system 归 system. 反正也不大。此外,如果自己就更新了系统的 ruby,要是遇到兼容性问题,修改起来很麻烦。

homebrew 的安装方法在官网说得非常详细, 就不赘述了. 稍微提一句, 若是新的用户, 安装完毕后, 需要保证你的环境变量 PATH -- 即程序的搜寻路径 -- 列表中, /usr/local/bin 的位置是在 /usr/bin 前面的.

通常而言,在 Linux/Unix 系统中,程序使用 PATH 这个环境变量作为搜寻路径列表。这个环境变量用冒号 (colon) 作为有序的多个路径的间隔,每当你输入一个命令的时候,程序都会尝试逐个查询 PATH 中提到的路径,执行第一个包含对应名字的可执行文件。

我们可以简单通过命令 echo $PATH 来查看当前的路径列表。

若没明白也没关系, 你可以考虑安装后先执行下 brew doctor, 它会帮你执行一系列环境相关检查, 对你提出很多建设性的意见. PATH环境变量的问题应该也会有一些相关说明,可以作为进一步的处理介绍。

brew 就绪后,安装 ruby, 一条命令即可:

brew install ruby

然后再 gem 下

$ gem install tmbundle-manager
Fetching: thor-0.19.1.gem (100%)
Successfully installed thor-0.19.1
Fetching: tmbundle-manager-0.1.2.gem (100%)
Successfully installed tmbundle-manager-0.1.2
Parsing documentation for thor-0.19.1
Installing ri documentation for thor-0.19.1
Parsing documentation for tmbundle-manager-0.1.2
Installing ri documentation for tmbundle-manager-0.1.2
Done installing documentation for thor, tmbundle-manager after 1 seconds
2 gems installed

默认情况下, brew 的各种 gems 会装到 /usr/local/lib/ruby/gems/2.3.0 这个位置. 2.3.0 是版本号, 也许在其它位置. 而不是原来的 /Library/Ruby/Gems/2.0.0 这个位置.

完了我们检查下 gem, 发现自带的和系统的完全就用两套库了. 非常好

$ which gem
/usr/local/bin/gem
$ gem list --local

*** LOCAL GEMS ***

bigdecimal (1.2.8)
did_you_mean (1.0.0)
io-console (0.4.5)
json (1.8.3)
minitest (5.8.3)
net-telnet (0.1.1)
power_assert (0.2.6)
psych (2.0.17)
rake (10.4.2)
rdoc (4.2.1)
test-unit (3.1.5)
thor (0.19.1)
tmbundle-manager (0.1.2)

$ /usr/bin/gem list --local

*** LOCAL GEMS ***

activesupport (3.2.19)
bigdecimal (1.2.0)
CFPropertyList (2.2.8)
colored (1.2)
i18n (0.6.11)
io-console (0.4.2)
json (1.7.7)
libxml-ruby (2.6.0)
minitest (4.3.2)
multi_json (1.10.1)
nokogiri (1.5.6)
psych (2.0.0)
rake (0.9.6)
rdoc (4.0.0)
rubygems-update (2.4.2)
sqlite3 (1.3.7)
test-unit (2.0.0.0)
xcodeproj (0.19.4)

补充,关于 PATH 的配置,还是不熟悉,或者对机制感兴趣的,可以参考此处。鸟哥的私房菜可以说是很多小朋友接触终端的启蒙了。而作为 Fedora 粉的我和他的书使用了红帽家的 CentOS 也绝对是大有关系的。

Categories: Code

Yu

Ideals are like the stars: we never reach them, but like the mariners of the sea, we chart our course by them.

6 Comments

ryin · May 10, 2017 at 13:07

Safari 8.0.7 Safari 8.0.7 Mac OS X  10.10.4 Mac OS X 10.10.4

非常感谢!解决了问题。不只是ruby,mac的很多自带的东西都有这个毛病……

    yu · May 10, 2017 at 21:28

    Google Chrome 57.0.2987.133 Google Chrome 57.0.2987.133 Mac OS X  10.12.4 Mac OS X 10.12.4

    @ryin 能有幸对你有所帮助, 真是太好了

zz · November 25, 2016 at 11:12

Google Chrome 54.0.2840.98 Google Chrome 54.0.2840.98 Mac OS X  10.12.0 Mac OS X 10.12.0

你好。
我在执行完
`brew install ruby` 后,再执行 `gem install fir-cli` 还是会提出没有权限的那个错误哎。
错误:
You don’t have write permissions for the /Library/Ruby/Gems/2.0.0 directory

    yu · November 25, 2016 at 17:18

    Google Chrome 54.0.2840.98 Google Chrome 54.0.2840.98 Mac OS X  10.12.1 Mac OS X 10.12.1

    @zz
    修改 ~/.bash_profile (没有就创建个, 若你用的是 zsh 之类则创建或修改对应的 profile 文件,应该是叫 .zprofile ),添加搜寻路径如下

    export PATH=/usr/local/bin:$PATH
    

    然后 source ~/.bash_profile apply 它。

    brew 安装的程序都在 /usr/local 目录下, 你保证搜寻 /usr/local/bin 在 /usr/bin 之前。

    此外,你可以考虑

    brew doctor
    

    让 brew 自检一下

Daniel · September 11, 2016 at 14:31

Google Chrome 53.0.2785.101 Google Chrome 53.0.2785.101 Mac OS X  10.11.6 Mac OS X 10.11.6

但我出现了这个Error在输完brew install ruby后
Error: Permission denied – (../../../Homebrew/share/man/man1/brew-cask.1, /usr/local/share/man/man1/brew-cask.1)
Error: You must `brew link pkg-config libyaml` before ruby can be installed

    yu · September 12, 2016 at 13:59

    Google Chrome 52.0.2743.116 Google Chrome 52.0.2743.116 Mac OS X  10.11.6 Mac OS X 10.11.6

    @Daniel
    它的意思是你无权写 /usr/local/share/man/man1/brew-cask.1 之类目录。可能是权限问题,比如你以前 sudo 操作了 /usr/local 的内容

    你有两种选择。
    其一,你命令前加 sudo, 即以 root 的名义执行此事。这样是可以通过的,但是可能并不太有必要。
    其二,你可以修改下 /usr/local 的权限,命令

    sudo chown -R your-user-name /usr/local
    

    这样可能会持续一段时间,它会让 /usr/local 的所有文件都拥有者都是你。

    随后你可以执行

    brew doctor
    

    它可能会给你一些其它修改意见,请按照提示执行。

    最后你在执行命令

    brew install ruby
    

    之前,可以按照提示先执行 brew link pkg-config libyaml , 这个提示意味着你在之前安装 libyaml 的时候已经遇到了一些未完成的事情,请先完成它的安装。

Leave a Reply to yu Cancel reply

Your email address will not be published. Required fields are marked *