安裝Rails開發環境
最后更新于：2022-04-01 02:31:04
> Give someone a program, you frustrate them for a day; teach them how to program, you frustrate them for a lifetime. - David Leinweber
在這一章中，我們將介紹如何安裝Ruby on Rails的開發環境。開發Rails的環境需要：
* Ruby 1.9.3以上版本或JRuby，本書使用2.2.2。
* 資料庫系統，Rails預設使用[SQLite](http://www.sqlite.org/)可以作為新手開發練習之用，正式上線環境則推薦使用[MySQL](http://www.mysql.com/)或[PostgreSQL](http://www.postgresql.org/)。
* Ruby on Rails，本書適用4.2版本。
> [JRuby](http://jruby.org/)與Ruby最大的差異在於一些需要編譯的RubyGem套件：有些因為效能要求而用C語言撰寫的RubyGem在JRuby上不一定能夠安裝使用。所幸這些多半都有替代的套件可以使用，但不在本書介紹範圍。
以上差不多就是最基本的開發需求。如果需要部署到正式上線環境，則至少還需要一個專門的網站伺服器(Apache或Nginx等)，我們會在佈署一章再詳細說明。接下來我們會根據不同作業系統來說明如何安裝Rails開發環境。
## 作業系統
Ruby可以運行在Windows、Linux、Mac OS X、BSD和Solaris上。雖然Rails可以在Windows上執行，但是有些套件只有支援Unix-like作業系統，以及Ruby程式在Unix-like系統上執行起來也比較快速及穩定。這是因為絕大多數的Ruby和Rails開發人員都是使用Mac和Linux系統。
> Unix-like泛指各種傳統的Unix系統，比如FreeBSD、OpenBSD、Solaris，以及各種與Unix類似的系統，例如Linux、Mac OS X等等。有的是自由軟體，有的是商業軟體，但都相當程度地保留了原始Unix系統的特性，以及有許多相似之處。
因此，Rails的正式上線環境中都會強烈建議使用Unix-like作業系統。作為開發人員，擁有良好使用者介面、底層又與Unix類似的Mac作業系統就變成了首選的開發平台，大部分的專業Ruby工作者，也都是使用Mac電腦。不過，使用Windows的朋友也別太擔心，本書的內容大致適用，入門學習應該沒問題。只是如果讀者的每日工作就是進行Web網站開發，那麼我會建議您考慮使用[Mac OS](https://www.apple.com/osx/)系統或試試[Ubuntu Desktop](http://www.ubuntu.com/desktop)作業系統。和學習Ruby一樣，從 Windows轉換到頭來Mac也是非常有趣的事情，可以獲得不少樂趣。
> 這是使用開源軟體需要考慮的因素：開源軟體是靠社群維護的，因此較多人使用的主流平台(作業系統、資料庫等)就會支援較佳，而越少人用的平台就會地雷較多。
## 資料庫
Rails支援的資料庫包括SQLite3、MySQL、Postgres、[IBM DB2](http://programmingzen.com/category/databases/db2/)、[Oracle](https://github.com/rsim/oracle-enhanced)和[SQL Server](http://www.engineyard.com/blog/2011/modern-sql-server-rails/)等。除了安裝資料庫軟體，我們也需要安裝搭配的Ruby函式庫(稱作Adapter或Driver)。作為新手的單機練習，使用SQLite就可以了，本章會先介紹SQLite的安裝方式。[附錄](https://ihower.tw/rails4/advanced-installation.html)則會介紹如何安裝MySQL和PostgreSQL。
## 開發環境
### 命令列視窗
有許多工作需要透過指令列介面CLI (Command Line Interface)完成，像是安裝套件、執行rails指令、執行測試等等。雖然有一些GUI圖型介面工具可以輔助，但是到頭來你會發現還是直接在指令列輸入最快最可靠，發生問題的時候也容易除錯。
Mac OS下要進入命令列視窗，請打開Go->Utilities中的Terminal，或是筆者推薦可以安裝[iTerm2](http://iterm2.com/)。Ubuntu Desktop下是Applications->Accessories下的Terminal。Windows則是「開始->附屬應用程式」中的「命令提示字元」。
Unix-like的指令和Windows的指令很多是不同的，以下是一些常用的指令：
| 用途 | Unix-like | Windows |
| --- | --- | --- |
| 移動所在目錄 | cd XXX | cd XXX |
| 移動到上一層目錄 | cd .. | cd .. |
| 顯示目前所在目錄 | pwd | cd |
| 顯示目前目錄的檔案 | ls | dir |
| 刪除檔案 | rm XXX | erase XXX |
| 刪除目錄 | rmdir XXX | rmdir XXX |
| 建立目錄 | mkdir XXX | mkdir XXX |
另外，在輸入檔名或目錄名時，可以按tab來自動完成。
不熟稔CLI的話，建議可以閱讀[The designer’s guide to the OSX command prompt](http://wiseheartdesign.com/articles/2010/11/12/the-designers-guide-to-the-osx-command-prompt/)和[The Command Line Crash Course](http://cli.learncodethehardway.org/book/)進行惡補。
### 開發軟體
在開始寫點程式之前，讓我們先介紹一下有什麼推薦的編輯器。相較於靜態語言如C++、Java喜歡功能豐富的IDE(Integrated Development Environment)軟體，動態語言雖然也有一些IDE軟體，但是更多人比較偏好簡單的文字編輯器(Editor)加上命令列視窗就可以打遍天下。這是因為對表達能力強的動態語言來說，IDE提供的自動產生程式碼、編譯程式、複雜的瀏覽功能等等都不是這麼需要。
#### Editor文字編輯器
* [Sublime Text](http://www.sublimetext.com/) (Windows、Linux、Mac平台)
* [Notepad++](http://notepad-plus-plus.org/) (Windows平台)
* [Vim](http://www.vim.org/)
* [Emacs](http://www.gnu.org/software/emacs/)
#### IDE軟體
* [JetBrains RubyMine](http://www.jetbrains.com/ruby/)
> 無論用什麼編輯器，請注意檔案的格式要儲存成UTF-8，無BOM(byte-order mark)表頭。
### 版本控制系統
版本控制系統可以保存所有的程式變更，記錄誰改變什麼、在什麼時候、因為什麼原因，是團隊開發不可或缺的協同工具。Ruby社群普遍使用[Git](http://git-scm.com/)這套分散式版本控制系統。雖然學習Rails不必要學會Git，但是因為Rails本身以及絕大部分的相關套件都是使用Git版本控制系統、並放在[GitHub](http://github.com/)上。所以你最好還是安裝有Git並學會基本的操作。關於Git的介紹請參考附錄。
## 安裝Ruby及資料庫
以下是分別在Mac OSX、Ubuntu Desktop作業系統上，安裝Ruby最快速方便的方式。在上手Rails的開發之後，可以再參考[附錄](https://ihower.tw/rails4/advanced-installation.html)，依需求安裝不同開發環境。
### Mac OS X Yosemite (10.10)
我們使用[Homebrew](http://brew.sh/)這套工具來管理MacOS上的套件，這可以方便安裝一些常用的工具軟體，例如Git、MySQL，甚至是Memcached、Elasticsearch、Redis、MongoDB等等都可以透過Homebrew安裝。本書的Mac安裝步驟中會使用到Homebrew，它的安裝步驟是執行：
~~~
$ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
~~~
過程中會跳出一個視窗詢問是否安裝XCode的命令列開發者工具(Command Line Tools)，請選擇安裝。完成後回到命令列繼續Homebrew的安裝。
Mac OS雖然內建了Ruby，卻是比較舊的版本，這裡我們透過Homebrew安裝最新版的Ruby：
~~~
$ brew install ruby
~~~
完成之後輸入以下指令可以看到安裝的版本：
~~~
$ ruby -v
ruby 2.2.2p95 (2015-04-13 revision 50295) [x86_64-darwin14]
~~~
### Linux (Ubuntu Desktop 14.04 LTS)
首先進行Linux更新：
~~~
$ sudo apt-get update
$ sudo apt-get upgrade
~~~
安裝必要的套件：
~~~
$ sudo apt-get install build-essential bison openssl libreadline6 libreadline6-dev curl git-core zlib1g zlib1g-dev libssl-dev libyaml-dev libsqlite3-0 libsqlite3-dev sqlite3 libxml2-dev libxslt-dev autoconf libc6-dev
~~~
接著下載Ruby原始碼編譯，請參考[Ruby官網](http://www.ruby-lang.org/en/downloads/)下載最新2.1.5版本：
~~~
$ wget http://cache.ruby-lang.org/pub/ruby/2.1/ruby-2.1.5.tar.gz
$ tar xvfz ruby-2.1.5.tar.gz
$ cd ruby-2.1.5/
$ ./configure
$ make
$ sudo make install
~~~
安裝完成之後輸入以下指令可以看到安裝的版本：
~~~
$ git --version
git version 2.2.1
$ ruby -v
ruby 2.1.5p273 (2014-11-13 revision 48405) [x86_64-darwin13.0]
~~~
> [SQLite Manager](https://addons.mozilla.org/en-US/firefox/addon/sqlite-manager/)是一套Firefox plugin提供 SQLite的GUI操作介面，可以用來方便檢視資料庫的內容。
> 中文版Ubuntu的預設apt-get套件伺服器tw.archive.ubuntu.com有時候不太穩，必要時你可以修改/etc/apt/sources.list換成debian.nctu.edu.tw或archive.ubuntu.com。
### Windows 7
請至[RubyInstaller](http://rubyinstaller.org/)下載Ruby 2.1.5安裝包，如果Windows 7是64位元則下載Ruby 2.1.X (x64)的版本。安裝過程中請點選將Ruby加入可執行的路徑(Add Ruby executables to your PATH)。
> 我們開發用的SQLite3資料庫函式庫在Windows上不支援Ruby 2.2的版本，請下載2.1的版本。
安裝成功之後，打開「附屬應用程式」的「命令提示字元」，輸入以下指令可以看到安裝的版本：
~~~
$ ruby -v
ruby 2.1.5p273 (2014-11-13 revision 48405) [x64-mingw32]
~~~
另外，有一些RubyGems套件會需要編譯動作，所以還需要Development Kit。請下載DevKit-mingw64-32-4.7.2-20130224-1151-sfx.exe 或64位元的DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe，解壓縮放在C:\DevKit下，接著在「命令提示字元」中進入這個目錄，輸入以下指令：
~~~
$ cd C:\DevKit
$ ruby dk.rb init
$ ruby dk.rb install
~~~
> 另一種在Windows開發的方式則是使用虛擬機器(Virtual Machine)，例如用[VirtualBox](http://www.virtualbox.org/)來跑[Ubuntu Desktop Edition](http://www.ubuntu.com/desktop)，或是使用[Cygwin](http://www.cygwin.com/)來提供Unix-like環境。如此就可以避開Windows上的種種地雷。
## RubyGems簡介
RubyGems是Ruby的套件管理系統，讓你輕易安裝及管理Ruby函式庫。你可以在[RubyGems](http://rubygems.org/)上找到所有的Ruby開源套件。另外，讀者如果想找Ruby或Rails有哪些好用的套件，也可以瀏覽看看[The Ruby Toolbox](http://ruby-toolbox.com/)，這個站依照套件的熱門程度排序，非常方便。
### 常用指令
~~~
gem -v 告訴你 RubyGems 的版本
gem update --system 升級RubyGems的版本
gem install gem_name 安裝某個套件
gem list 列出安裝的套件
gem update gem_name 更新最新版本
gem update 更新所有你安裝的Gems
gem install -v x.x.x gemname 安裝特定版本
gem uninstall gem_name 反安裝
~~~
> 執行`gem install gem_name`的時候，它會在安裝完之後，自動產生此套件的RDoc和ri文件。不過有鑑於目前網路發達，往往直接 Google或是在套件官網就可以查詢到文件，所以其實不太需要在本地端機器產生文件，況且安裝的時間耗時又佔硬碟空間。要省略這個步驟，有兩種方式：
每次安裝時，加上以下參數：
~~~
$ gem install gem_name --no-ri --no-rdoc
~~~
或是新增一個`~/.gemrc`檔案內容如下，預設就不產生文件：
~~~
gem: --no-ri --no-rdoc
~~~
> Linux的使用者需要加上sudo，例如`sudo gem install gemname`。
## 安裝Ruby on Rails
~~~
$ gem install rails --no-ri --no-rdoc
~~~
為了節省安裝時間可不安裝文件檔，這裡加上`--no-ri`跟`--no-rdoc`參數。安裝完成之後，輸入`rails -v`你應該會看到Rails 4.2.0。
> Ubuntu下需要用root權限安裝套件：`sudo gem install rails`
使用者Windows的朋友很不幸地目前暫時需要一個[手動補釘](https://gist.github.com/luislavena/f064211759ee0f806c88)的動作才可以使用rubygem。首先請下載[rubygems-update-2.2.3.gem](https://github.com/rubygems/rubygems/releases/tag/v2.2.3)放到`C:\`下：
~~~
$ gem install --local C:\rubygems-update-2.2.3.gem
$ update_rubygems --no-ri --no-rdoc
$ gem uninstall rubygems-update
~~~
接著再執行一次`gem install rails --no-ri --no-rdoc`安裝Rails。
> 中國大陸地區的朋友如果碰到網路連線問題(你懂的)，可以改使用[RubyGems鏡像-淘寶網](http://ruby.taobao.org/)。