Ruby on Rails 安装指南

介绍 Mac、linux、windows 安装 rails 的方式

windows 安装 rails

就别瞎折腾了，直接使用 RailsInstaller 一键安装包

安装完成后，rails极可能用不了，需要命令行执行

gem update --system && gem update --no-document

当然，windows 部分的教程并没有到此结束，请直接跳到后面配置 RubyGems 镜像的教程。

*nix安装rails

Mac和Linux安装方式基本相同，此处我使用rbenv来安装，rbenv是管理多个ruby版本的工具，可以很方便的切换ruby的版本。

注意：尽量不要在root用户安装rails，要在普通用户安装

1. 安装rbenv

首先安装git，已安装跳过此步

# mac
brew install git
# centos
yum install git
# ubuntu
apt-get install git

然后安装rbenv

# 安装rbenv到~/.rbenv目录
git clone git://github.com/sstephenson/rbenv.git ~/.rbenv

下面安装一些rbenv的插件

# 用来编译安装 ruby
git clone git://github.com/sstephenson/ruby-build.git ~/.rbenv/plugins/ruby-build
# 用来管理 gemset, 可选, 因为有 bundler 也没什么必要
git clone git://github.com/jamis/rbenv-gemset.git  ~/.rbenv/plugins/rbenv-gemset
# 通过 gem 命令安装完 gem 后无需手动输入 rbenv rehash 命令, 推荐
git clone git://github.com/sstephenson/rbenv-gem-rehash.git ~/.rbenv/plugins/rbenv-gem-rehash
# 通过 rbenv update 命令来更新 rbenv 以及所有插件, 推荐
git clone git://github.com/rkh/rbenv-update.git ~/.rbenv/plugins/rbenv-update
# 使用 Ruby China 的镜像安装 Ruby, 国内用户推荐
git clone git://github.com/AndorChen/rbenv-china-mirror.git ~/.rbenv/plugins/rbenv-china-mirror

然后需要将下面两句代码放在bash的配置文件中：

export PATH="$HOME/.rbenv/bin:$PATH"
eval "$(rbenv init -)"

linux是一般是放在~/.bashrc中，mac是放在~/.bash_profile中

修改完成后，执行下面的命令使其生效

# linux
source ~/.bashrc
# mac
source ~/.bash_profile

2. 安装ruby

rbenv install --list  # 列出所有 ruby 版本

例如安装2.3.3：

rbenv install 2.3.3

设置使用的ruby版本, 有以下三种设置方式

rbenv global 2.3.3      # 默认使用2.3.3
rbenv shell 2.3.3       # 当前的 shell 使用2.3.3, 会设置一个 `RBENV_VERSION` 环境变量
rbenv local 2.3.3      # 当前目录使用2.3.3, 会生成一个 `.rbenv-version` 文件

3. 安装rails

设置ruby版本后，安装rails：

# 在当前的ruby版本中安装rails
gem install rails

好了，这样就完成了rails的安装，rails已经可以使用了，但是为了更好的使用，请继续看后面的教程。

配置RubyGems镜像

gem是ruby管理依赖包的工具，而RubyGems的默认地址因为万恶的墙的关系很难访问到，因此需要配置RubyGems 镜像。这里使用的是Ruby China的镜像地址

命令行输入

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

可以通过下面这个命令查看设置的结果是不是https://gems.ruby-china.org：

gem sources -l

对于Windows系统，会报下面这个错误：

Error fetching https://gems.ruby-china.org/:
    SSL_connect returned=1 errno=0 state=SSLv3 read server certificate B: certificate verify failed (https://gems.ruby-china.org/specs.4.8.gz)

报这个错的原因是 RailsInstaller 安装的 ruby 没有包含 SSL 证书，所以 https 的链接被服务器拒绝。

解决方法为：

下载证书文件 http://curl.haxx.se/ca/cacert.pem
然后设置 SSL_CERT_FILE 环境变量，变量值为cacert.pem文件的路径。

修改bundle的源地址

bundler是rails管理gem依赖的工具，同样的，也需要修改其地址为ruby china的镜像