Rails 開(kāi)發(fā)筆記

時(shí)間：2023-05-25 01:45:01 | 來(lái)源：網(wǎng)站運(yùn)營(yíng)

時(shí)間：2023-05-25 01:45:01 來(lái)源：網(wǎng)站運(yùn)營(yíng)

Rails 開(kāi)發(fā)筆記：

本筆記的目的是幫助自己記憶新建 Rails 項(xiàng)目時(shí)的步驟。

Rails 7 于 4月26日發(fā)布，但鑒于對(duì)新版本還不熟，暫時(shí)還是先玩玩 Rails 6，由于 Rails 本身提供的命令行工具構(gòu)建的項(xiàng)目腳手架過(guò)于簡(jiǎn)單，不能滿足日常開(kāi)發(fā)需要，每次都要新增很多 Gems 和配置，耗時(shí)耗力，又因?yàn)椴惶胧褂镁W(wǎng)上的 Jumpstart 模板，因此，最后還是自己做個(gè)筆記，記錄下新建 Rails 6 項(xiàng)目的過(guò)程，便于以后查找。

01｜Rails 的安裝（僅針對(duì) macOS）

欲裝 Rails 先裝 Ruby，盡管 macOS 系統(tǒng)自帶 Ruby 命令，但我通常在開(kāi)發(fā)機(jī)器上用 RVM 來(lái)安裝 Ruby，兩個(gè)好處：安裝簡(jiǎn)單和便于環(huán)境的切換（Rails 由于 Ruby 版本和自身版本差異性，經(jīng)常需要在不同的版本搭配間切換，如果只用系統(tǒng)的 Ruby 版本，那后續(xù)開(kāi)發(fā)起來(lái)就會(huì)比較費(fèi)勁了。）

0101 先安裝 rvm

打開(kāi)命令行工具（終端或 iTerm2），并輸入 $ curl -sSL https://get.rvm.io | bash -s stable 一頓操作后，便可以使用 rvm 命令來(lái)安裝 Ruby 了，具體可參考官網(wǎng) https://rvm.io

0102 安裝 Ruby

在安裝 Ruby 之前，最好先確定要使用的 Rails 版本，由于我想用的是 Rails 6 所以可以，基本上可以安裝 Ruby 2.5 以上的版本，這里正好想到了版本適配表，貼出來(lái)也便于記憶

·Rails 版本	適配的 Ruby 版本	最佳推薦 Ruby 版本	官方維護(hù)狀態(tài)
7.0.x	>= 3.1.0	3.1.x	維護(hù)中
7.0.0	>= 2.7.0	3.1.x	維護(hù)中
6.1.x	>= 2.5.0	3.0.x	維護(hù)中
6.0.x	>= 2.5.0 < 3.0.0	2.6.x	僅維護(hù)安全問(wèn)題
5.2.x	>= 2.2.2 < 2.7.0	2.5.x	僅維護(hù)截止到2022年6月的安全問(wèn)題
5.1.x	>= 2.2.2 < 2.6.0	2.5.x	不再維護(hù)
5.0.x	>= 2.2.2 < 2.5.0	2.4.x	不再維護(hù)
4.2.x	>= 1.9.3	2.2	不再維護(hù)
4.1.x to 4.2.0	>= 1.9.3	2.1	不再維護(hù)
4.0.5 to 4.1.0.rc2	>= 1.9.3		不再維護(hù)
4.0.0 to 4.0.x	>= 1.9.3		不再維護(hù)
3.2.x	1.8.7	2.0	不再維護(hù)
3.2.13 to 3.2.22.4	1.8.7	2.0	不再維護(hù)
2.3.0 to 3.2.13.rc2	1.8.7	1.9.3	不再維護(hù)
0.8.0 to 2.2.3.rc2	1.8.7		不再維護(hù)

最終，我選擇的搭配版本是 Ruby 2.7.5 + Rails 6.1.5，那就先裝 Ruby 2.7.5

$ rvm install 2.7.5

安裝完成之后，在輸入 $ rvm gemset create rails615 表示創(chuàng)建一個(gè)環(huán)境，接著可以安裝 Rails 6 了

$ gem install rails -v 6.1.5 --no-doc 簡(jiǎn)單解釋下 -v 就是指定安裝版本，--no-doc 表示不安裝文檔，因?yàn)槲臋n下載慢，而且下載的文檔不太實(shí)用，要查可以去網(wǎng)站上看。

等安裝完成后，再輸入 $ rvm use 2.7.5@rails615 --default 表示應(yīng)用該環(huán)境。

不過(guò)有個(gè)小坑，就是如果新建 Rails 項(xiàng)目后，需要在進(jìn)入目錄后再執(zhí)行一次應(yīng)用環(huán)境的命令。

02｜新建項(xiàng)目

環(huán)境解決了之后，就可以新建項(xiàng)目了。

0201 新建命令

$ rails new myapp -d postgresql -TB

-d是指定數(shù)據(jù)類型，支持 mysql、postgresql 等各種數(shù)據(jù)庫(kù)，-TB 不生成測(cè)試文件和不執(zhí)行 bundle 操作

建好項(xiàng)目之后進(jìn)入項(xiàng)目目錄 $ cd myapp

0202 編輯 Gemfile

把需要的 Gem 先安排上，一起安裝

source "https://rubygems.org"git_source(:github) { |repo| "https://github.com/#{repo}.git" }ruby "2.7.5"gem "rails", "~> 6.1.5", ">= 6.1.5.1"gem "pg", "~> 1.1"gem "puma", "~> 5.0"gem "sass-rails", ">= 6"gem "webpacker", "~> 5.0"gem "turbolinks", "~> 5"gem "jbuilder", "~> 2.7"gem "bootsnap", ">= 1.4.4", require: falsegroup :development, :test do gem "byebug", platforms: [:mri, :mingw, :x64_mingw]endgroup :development do gem "web-console", ">= 4.1.0" gem "rack-mini-profiler", "~> 2.0" gem "listen", "~> 3.3" gem "spring"endgem "tzinfo-data"gem "cssbundling-rails"gem "jsbundling-rails"gem "devise", "~> 4.8", ">= 4.8.0"gem "friendly_id", "~> 5.4"gem 'omniauth-facebook', '~> 8.0'gem 'omniauth-github', '~> 2.0'gem 'omniauth-twitter', '~> 1.4'gem 'pundit', '~> 2.1'gem 'sidekiq', '~> 6.2'gem 'whenever', require: false編輯保存后，執(zhí)行 $ bundle install 安裝 Gems，然后確保系統(tǒng)安裝了 NodeJS 和 Yarn（1.x 版本，貌似對(duì) Yarn 3 版本不太友好），然后執(zhí)行 $ yarn install 安裝前端依賴包。

0203 安裝 js 和 css 編譯支持

執(zhí)行 $ rails javascript:install:esbuild 和 $ rails css:install:bootstrap 安裝 js 和 css 的編譯支持。

0204 創(chuàng)建數(shù)據(jù)庫(kù)

執(zhí)行 $ rake db:create 創(chuàng)建數(shù)據(jù)庫(kù)，前提是你已經(jīng)安裝了指定的數(shù)據(jù)庫(kù)，并配置了 database.yml 文件

0204 啟動(dòng)程序

此時(shí)應(yīng)該可以啟動(dòng) Rails 程序了，執(zhí)行 bin/dev




未完待續(xù) ...