windows下安装ruby与rails时遇到的问题总结

前言

最近因为工作的需要，准备安装ruby on rails，在网上搜了下，步骤都类似，但实际安装过程中却碰到很多问题。

说明下：文章是按照我尝试的过程描述的。但最终是靠 运行 railsinstaller一键式安装包才成功的（第五段），因此前面的部分大家可以看看，但不用去尝试。

下面来看看详细的介绍吧：

一、首先要安装ruby

因为在windows下安装ruby，都是推荐下载rubyinstaller安装程序。

先进入ruby官网http://www.ruby-lang.org/en/downloads/ ，

通过上面链接进入http://rubyinstaller.org/

直接下载了一个最新版本rubyinstaller-2.3.0.exe （针对ruby 2.3.0版本的）。

下载正常，安装也正常，在命令行下测试 ruby -v 成功。

但是后面在通过  gem install rails 报错，报错信息如下

ERROR: Error installing rails:
  nokogiri requires Ruby version < 2.3, >= 1.9.2.

</div>

很明显，ruby版本太高，所以重新下载了rubyinstaller-2.2.4.exe（针对Ruby 2.2.4版本）。

当然这是后话，这里先说出来，就是避免大家一样跟我重复。但也可能，当你安装时就没问题了。反正我是碰到问题了。

二、安装rails

通过ruby gem来在线安装。RubyGems是一个方便而强大的Ruby程序包管理器，类似RedHat的RPM。

它将一个Ruby应用程序打包到一个gem里，作为一个安装单元。

先在命令行下 输入  gem -v 测试gem是否正常，测试发现正常。

然后在命令行下输入 gem install rails

但是等待半天后，报网络错误， 后来在网上搜了下，因为gem默认用的源是https://rubygems.org/，

但由于国内网络的原因，会连不上，可以用淘宝提供的镜像 https://ruby.taobao.org/ 来代替。

于是这行下面的操作：

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

</div>

上面操作是删除源，删除后用  gem sources -l 发现删除成功了。

需要说明下 gem 后的命令 ，如这里的sources不一定要写全，只要不冲突可以，比如 gem source , gem so 都是可以的。

然后执行 gem sources --add https://ruby.taobao.org/ ，但总是报错

Error fetching https://ruby.taobao.org/:
  SSL_connect returned=1 errno=0 state=SSLv3 r

</div>

试着把https改为 http,  gem sources --add http://ruby.taobao.org/，又是报如下错误

Error fetching http://ruby.taobao.org/:
  bad response Not Found 404 (http://ruby.taobao.org/specs.4.8.gz)

</div>

试了多次，还是不行。

后来又找了下，发现 ruby china上提供了源  ，官网 https://ruby-china.org/上给出了命令gem source -a https://gems.ruby-china.org

于是执行 gem source -a https://gems.ruby-china.org ，但是还是报错

Error fetching https://gems.ruby-china.org:
  SSL_connect returned=1 errno=0 state=SSLv3 read s

</div>

没有办法，试着把https改为http，竟然成功了

C:\Windows\System32>gem source -a http://gems.ruby-china.org
http://gems.ruby-china.org added to sources

</div>

查看一下，是成功的。

C:\Windows\System32>gem source -l

*** CURRENT SOURCES ***

http://gems.ruby-china.org

</div>

既然，源设置正确了，下面那就安装rails吧，于是在命令行下运行 gem install rails

等待一会后，命令下开始输出安装过程信息了，当以为应该没有问题的时候，结果又报错，安装停止了，报错信息如下

......

Fetching: rails-deprecated_sanitizer-1.0.3.gem (100%)
Successfully installed rails-deprecated_sanitizer-1.0.3
Fetching: rails-dom-testing-1.0.7.gem (100%)
Successfully installed rails-dom-testing-1.0.7
ERROR: While executing gem ... (Gem::RemoteFetcher::FetchError)
 bad response Gateway Time-out 504 (http://gems-ruby-china.b0.upaiyun.com/quick/Marshal.4.8/loofah-2.0.3.gemspec.rz)

</div>

晕了，再接着试下运行gem install rails，这次有很多输出了，但输出很长时间候，停在某条信息上了不再继续，也没终止

......

ng ri documentation for sprockets-rails-3.0.4
documentation for rails-4.2.6
ng ri documentation for rails-4.2.6

</div>

看这个信息，是在安装文档，心想文档应该不是关键模块，试着打开一个新的命令行，运行 rails -v，发现成功输出，说明 rails可能安装成功了。

还是不太放心，前面在网上查询时了解到 gem install rails --no-rdoc --no-ri 可以不安装文档。

于是把命令行强制终止，并运行gem install rails --no-rdoc --no-ri，看看有啥反应

.....

Installing ri documentation for rails-4.2.6 

ERROR: Interrupted 

 
终止批处理操作吗(Y/N)? y

C:\Windows\System32>gem install rails --no-rdoc --no-ri 

Successfully installed rails-4.2.6 1 gem installed

C:\Windows\System32>rails -v 

Rails 4.2.6

</div>

这下比较放心了，说明rails安装成功了。

三、测试ruby

编写和运行ruby，可以有几种方式

1、运行 irb 程序，启动交互式界面

2、将ruby代码编写到文件中，保存 .rb文件，在命令行下用 ruby执行该文件。

3、到http://www.scintilla.org/SciTEDownload.html上下载一个ide工具，来编写和运行ruby程序

四、测试rails

执行” rails new 目录名 " 创建一个ruby框架的web工程的框架。

但发现报错，报缺少sqllite等模块。

后来又在网上查了下，ruby on rails依赖很多模块。

在window下要安装rails 最好用 railsinstaller 来安装。 下面我们来介绍如何利用railsinstaller 来安装。

五、利用 railsinstaller 安装 ruby 和 rails

进入官网http://railsinstaller.org/en

先是下载 了windows下最新的 railsinstaller-3.2.0.exe，安装没有问题。

但发现 rails.bat无法运行，打开一个，里面的脚本写的有问题。因为不知道是不是只有这一个问题。

因此重新下载了稍微低的版本railsinstaller-3.1.1.exe，安装成功后，检查各项版本：

C:\Windows\System32>ruby -v
ruby 2.1.8p440 (2015-12-16 revision 53160) [i386-mingw32]

C:\Windows\System32>gem -v
2.2.5

C:\Windows\System32>bundle -v
Bundler version 1.12.0.pre.1

C:\Windows\System32>rails -v
Rails 4.2.5.1

</div>

安装成功后，除选择的安装目录外，还在c盘下创建一个 sites目录，里面有个ruby on rails的例子工程。

六、测试rails

运行 rails new demo  ，这里的demo是测试工程。

运行后，前面一部分是成功的，但最后报错了。

c:\Sites>rails new demo
   create
   create README.rdoc
   create Rakefile

.....................

   create vendor/assets/stylesheets/.keep
     run bundle install
Checksum of /versions does not match the checksum provided by server! Something is wrong.

</div>

因为创建工程会下载很多模块，会到默认的镜像  https://rubygems.org/ 上去获取，而这个镜像是很难连上去的。

因此需要修改镜像。

修改 demo目录下的 Gemfile 文件，

源文件第一行语句是  source 'https://rubygems.org'

需要修改为 source 'http://gems.ruby-china.org'  ，这个镜像在本文的前面有介绍，不再重复说明。

修改后，重新执行 rails new demo，注意原来生成的demo内容不变。

执行的信息如下：

c:\Sites>rails new demo