創建 Rails 項目

創建一個普通的 Rails 項目，可以直接使用以下命令:

rails new blog

但在國內因為連接 RubyGems 的速度太慢，而 Rails 默認在構建完項目結構后，會使用 bundle 命令從 RubyGems 下載安裝依賴包。最后會因為網絡問題而卡死。所以需要使用 --skip-bundle 參數跳過執行 bundle 這一步。然后使用國內的 Gems 鏡像源來完成后面依賴包的安裝。國內推薦的源是 Ruby China 提供的: https://gems.ruby-china.org/。

最后整理步驟如下：

創建項目:

rails new blog --skip-bundle

修改項目目錄中的 Gemfile 文件，修改第一行中 source 后面引號中的內容值為：https://gems.ruby-china.org/
最后在項目目錄中執行: bundle install 完成安裝依賴包。
至此，一個標準的 Rails 項目骨架創建完成。

配置 Rails 項目

默認情況下，已經可以使用生成好的項目骨架來開始開發項目，但根據實際需求，還是需要對一些配置進行調整。比如時區，或使用 MySQL 等。

設置時區

默認 Rails 使用的是 UTC 時區，如果項目只是在國內使用，這會導致數據跟時間相關的值都會比國內的時間晚 8 個小時。所以如果非國際性項目，可以把時區固定到國內。

打開項目目錄中 config/application.rb 文件。去掉 config.time_zone 配置項前的注釋，然后修改配置項的值為 Beijing，最后添加一行新的配置:

config.active_record.default_timezone = :local

使用 MySQL

默認 Rails 使用的是 sqlite 數據庫，如果要使用 MySQL，還需要安裝 MySQL 的程序包。并修改數據庫默認配置。

打開項目目錄中的 Gemfile 文件，添加一個全局的依賴包 mysql2，格式如下:

gem 'mysql2'

然后執行: bundle install 安裝依賴包。

接下來打開 config/database.yml 文件，修改 development 區塊的配置如下格式:

development: adapter: mysql2 database: blog username: root password: host: 127.0.0.1

創建 Rails 文檔

對于已經熟練掌握了 Rails 的老手來說，這一步并不是必須的。但對于像我這樣的新手，經常會需要去翻翻手冊來尋求幫助，把文檔搬到本地，省去了在沒有網絡或網速太慢時的煩惱。Rails 提供了命令，可以在項目中生成 Rails 的本地手冊和 API 文檔。

首先需要添加一個依賴包: redcarpet。打開項目中的 Gemfile 文件，因為只是在本地環境下使用，所以不用加入到全局依賴，找到文件底部的 development 配置塊，添加到這里就行了，格式如下:

gem 'redcarpet', '~> 3.1.2'

然后執行: bundle install 安裝包。

使用如下命令生成 Rails 幫助文檔和 API 文檔: