安裝 Rails 開發環境

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 2.2.2以上版本或JRuby，本書使用2.4.0。
資料庫系統，Rails預設使用SQLite可以作為新手開發練習之用，正式上線環境則推薦使用MySQL或PostgreSQL。
Ruby on Rails，本書適用5.0+版本。

JRuby與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系統或試試Ubuntu Desktop作業系統。和學習Ruby一樣，從 Windows轉換到頭來Mac也是非常有趣的事情，可以獲得不少樂趣。

這是使用開源軟體需要考慮的因素：開源軟體是靠社群維護的，因此較多人使用的主流平台(作業系統、資料庫等)就會支援較佳，而越少人用的平台就會地雷較多。

資料庫

Rails支援的資料庫包括SQLite3、MySQL、Postgres、IBM DB2、Oracle和SQL Server等。除了安裝資料庫軟體，我們也需要安裝搭配的Ruby函式庫(稱作Adapter或Driver)。作為新手的單機練習，使用SQLite就可以了，本章會先介紹SQLite的安裝方式。附錄則會介紹如何安裝MySQL和PostgreSQL。

開發環境

命令列視窗

有許多工作需要透過指令列介面CLI (Command Line Interface)完成，像是安裝套件、執行rails指令、執行測試等等。雖然有一些GUI圖型介面工具可以輔助，但是到頭來你會發現還是直接在指令列輸入最快最可靠，發生問題的時候也容易除錯。

Mac OS下要進入命令列視窗，請打開Go->Utilities中的Terminal，或是筆者推薦可以安裝iTerm2。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和The Command Line Crash Course進行惡補。

開發軟體

在開始寫點程式之前，讓我們先介紹一下有什麼推薦的編輯器。相較於靜態語言如C++、Java喜歡功能豐富的IDE(Integrated Development Environment)軟體，動態語言雖然也有一些IDE軟體，但是更多人比較偏好簡單的文字編輯器(Editor)加上命令列視窗就可以打遍天下。這是因為對表達能力強的動態語言來說，IDE提供的自動產生程式碼、編譯程式、複雜的瀏覽功能等等都不是這麼需要。

Editor文字編輯器

Sublime Text (Windows、Linux、Mac平台)
ATOM (Windows、Linux、Mac平台)
Vim

IDE軟體

JetBrains RubyMine

無論用什麼編輯器，請注意檔案的格式要儲存成UTF-8，無BOM(byte-order mark)表頭。

版本控制系統

版本控制系統可以保存所有的程式變更，記錄誰改變什麼、在什麼時候、因為什麼原因，是團隊開發不可或缺的協同工具。Ruby社群普遍使用Git這套分散式版本控制系統。雖然學習Rails不必要學會Git，但是因為Rails本身以及絕大部分的相關套件都是使用Git版本控制系統、並放在GitHub上。所以你最好還是安裝有Git並學會基本的操作。關於Git的介紹請參考附錄。

安裝Ruby及資料庫

以下是分別在Mac OSX、Ubuntu Desktop作業系統上，安裝Ruby最快速方便的方式。在上手Rails的開發之後，可以再參考附錄，依需求安裝不同開發環境。

Mac OS X

我們使用Homebrew這套工具來管理MacOS上的套件，這可以方便安裝一些常用的工具軟體，例如Git、MySQL，甚至是Memcached、Elasticsearch、Redis、MongoDB等等都可以透過Homebrew安裝。本書的Mac安裝步驟中會使用到Homebrew，它的安裝步驟是執行：

$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

過程中會跳出一個視窗詢問是否安裝XCode的命令列開發者工具(Command Line Tools)，請選擇安裝。如果沒有的話，請手動執行 xcode-select --install 這個指令。

完成後回到命令列繼續Homebrew的安裝。

Mac OS雖然內建了Ruby，卻是比較舊的版本，這裡我們透過Homebrew安裝最新版的Ruby：

$ brew install ruby

完成之後輸入以下指令可以看到安裝的版本：

$ ruby -v
ruby 2.4.1p111 (2017-03-22 revision 58053) [x86_64-darwin16]

Windows

請至RubyInstaller下載Ruby安裝包，如果Windows是64位元則下載(x64)的版本。安裝過程中請點選將Ruby加入可執行的路徑(Add Ruby executables to your PATH)。

我們開發用的SQLite3資料庫函式庫在Windows上不支援Ruby 2.2的版本，請下載2.1的版本。(2015-06-09 的實驗結果，後來有沒有支援不清楚)

安裝成功之後，打開「附屬應用程式」的「命令提示字元」，輸入以下指令可以看到安裝的版本：

$ 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來跑Ubuntu Desktop Edition，或是使用Cygwin來提供Unix-like環境。如此就可以避開Windows上的種種地雷。

RubyGems簡介

RubyGems是Ruby的套件管理系統，讓你輕易安裝及管理Ruby函式庫。你可以在RubyGems上找到所有的Ruby開源套件。另外，讀者如果想找Ruby或Rails有哪些好用的套件，也可以瀏覽看看The Ruby Toolbox，這個站依照套件的熱門程度排序，非常方便。

常用指令

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

安裝Ruby on Rails

$ gem install rails --no-ri --no-rdoc

為了節省安裝時間可不安裝文件檔，這裡加上--no-ri跟--no-rdoc參數。安裝完成之後，輸入rails -v你應該會看到Rails 5.1.0。

使用者Windows的朋友可能需要手動安裝，請參考 INSTALLING USING UPDATE PACKAGES

中國大陸地區的朋友如果碰到網路連線問題(你懂的)，請改使用RubyGems鏡像- Ruby China。