初识 Ruby on Rails：为开发者准备的快速指南

引言

作为开发者，我们不断寻求能够提升效率、简化流程、帮助我们将创意迅速转化为现实的工具。在Web开发领域，这样的工具层出不穷，而 Ruby on Rails（通常简称为 Rails）无疑是其中最耀眼的一颗星。自2004年问世以来，Rails 就以其“魔法”般的开发速度和优雅的代码风格征服了无数开发者，并催生了 Twitter、Shopify、GitHub 等众多知名网站。

或许你已经听说过它的鼎鼎大名，或许你正准备开始一个Web项目并考虑技术选型。这篇文章正是为你准备的。我们将深入浅出地探讨 Rails 的核心概念、哲学原则、工作流程，以及如何快速上手构建你的第一个 Rails 应用。无论你熟悉 Ruby 语言与否，只要你具备基本的编程思维和对Web开发的好奇心，这篇指南都将为你推开 Rails 世界的大门。

第一部分：Rails 简介与哲学基础

1.1 什么是 Ruby on Rails？

Ruby on Rails 是一个使用 Ruby 语言编写的开源 Web 应用框架。它提供了一套完整的结构、工具和约定，用于快速开发数据库驱动的 Web 应用。简单来说，Rails 为Web开发的方方面面提供了解决方案，从处理用户请求、与数据库交互、生成HTML页面，到处理表单提交、管理用户会话等等。

Rails 的设计哲学强调以下两点：

Convention Over Configuration (CoC)：约定优于配置
这是 Rails 最核心的理念之一。Rails 相信大多数Web应用都有相似的结构和需求，因此它为许多常见的任务提供了默认的约定（Conventions）。只要你遵循这些约定，就能省去大量的配置工作。例如，模型类的名称通常对应数据库表的名称（单数 vs 复数），控制器的方法名称对应常见的HTTP动词（GET, POST等），文件应该放在特定的目录下等等。这种哲学大大减少了开发者需要做出的决策，提高了开发效率。
Don’t Repeat Yourself (DRY)：不要重复自己
DRY 是软件开发中的一条通用原则，Rails 将其贯穿始终。Rails 提供了各种机制（如 Mixins, Helpers, Partials等）来鼓励代码的复用，避免功能的冗余实现。遵循 DRY 原则可以使代码更易于维护、更健壮。

正是基于这些哲学，Rails 提供了一种高效、愉快的方式来构建Web应用。

1.2 为什么选择 Rails？

对于开发者而言，选择一个框架通常基于以下考量：

开发速度快： CoC 和 DRY 原则，加上丰富的内置功能（如 Active Record 的 ORM、Action Pack 的 MVC 结构）和庞大的 Gem（第三方库）生态系统，使得开发者能够以惊人的速度构建出功能完善的应用原型乃至正式产品。许多“最小可行产品”(MVP) 都是在短时间内用 Rails 搭建起来的。
全栈框架： Rails 涵盖了从后端数据库到前端视图的整个Web开发栈。这意味着你可以在一个框架内完成大部分工作，减少了技术栈的割裂感。
结构清晰： Rails 推崇 MVC（Model-View-Controller）架构模式，这使得应用的代码结构清晰、职责分离，易于理解和维护，特别适合团队协作。
活跃的社区和丰富的资源： Rails 拥有一个庞大而活跃的全球开发者社区。遇到问题时，你可以很容易地找到帮助、教程、博客文章或 Gem 来解决。
测试友好： Rails 内置了对自动化测试的支持，鼓励开发者编写测试，这对于构建健壮、可维护的应用至关重要。
安全性考虑： Rails 在设计上考虑了许多常见的Web安全问题，并提供了相应的防护机制（如 CSRF 防护、SQL注入防护等）。

当然，没有任何一个框架是完美的。Rails 也可能存在一些缺点，例如：

学习曲线： 虽然入门容易，但要精通 Rails 并理解其“魔法”背后的原理需要时间和经验。
运行时性能： 对于某些对性能要求极致、或者并发量极高的简单应用场景，Ruby 语言本身的解释性以及 Rails 的一些抽象层可能不如编译型语言或更底层的框架效率高。但对于大多数Web应用而言，Rails 的性能是完全足够的，并且可以通过优化数据库查询、使用缓存、异步任务等手段来提升。
依赖管理： 虽然 Bundler 是优秀的依赖管理工具，但庞大的项目依赖链有时也可能带来版本冲突等问题。

总的来说，对于需要快速迭代、功能丰富、结构清晰的Web应用开发，Rails 依然是一个非常有竞争力的选择。

1.3 核心架构：MVC

MVC（Model-View-Controller）是一种软件设计模式，用于将应用程序分离为三个相互关联的部分。Rails 是一个典型的 MVC 框架。理解 MVC 是理解 Rails 工作原理的关键。

Model (模型)： 负责处理应用程序的数据和业务逻辑。在 Rails 中，Model 通常与数据库中的表对应（通过 Active Record）。Model 知道如何存储、检索、验证和关联数据。它不关心用户界面，只专注于数据的管理。
- 示例： 一个 User 模型知道如何从数据库中查找用户、如何验证用户输入的密码、如何存储用户资料。
View (视图)： 负责呈现数据给用户。它从 Controller 接收数据，并将其格式化为用户可以理解的输出（通常是 HTML）。View 应该只包含展示逻辑，不包含业务逻辑。
- 示例： 一个用于显示用户个人资料的 show.html.erb 文件，它接收一个 @user 对象，然后渲染出用户的姓名、邮箱等信息。
Controller (控制器)： 负责处理用户请求、调用 Model 进行数据处理，并选择合适的 View 来响应用户。Controller 是 Model 和 View 之间的协调者。当用户发起一个请求（如访问一个URL）时，Router（路由器）会将请求导向相应的 Controller 的某个方法（称为 Action）。Controller 在 Action 中执行业务逻辑（可能涉及与 Model 的交互），然后决定渲染哪个 View，并将数据传递给 View。
- 示例： 一个 UsersController 的 show Action，它接收用户ID，通过 User 模型查找对应用户，然后将该用户对象传递给 show.html.erb 视图进行渲染。

MVC 模式的优点在于职责分离：Model 专注于数据，View 专注于展示，Controller 专注于协调。这使得代码更易于组织、理解、测试和维护。

第二部分：快速上手 Rails

2.1 环境准备

在开始构建 Rails 应用之前，你需要准备好开发环境。Rails 依赖于 Ruby 语言和一些其他工具。

安装 Ruby： Rails 需要特定版本的 Ruby。推荐使用 Ruby 版本管理器，如 rbenv 或 RVM。它们可以让你在同一台机器上安装和管理多个 Ruby 版本，避免版本冲突。
- 安装 rbenv (macOS/Linux):
  bash brew install rbenv ruby-build # macOS with Homebrew # 或者通过git安装：https://github.com/rbenv/rbenv#installation
- 安装 Ruby (使用 rbenv):
  bash rbenv install 3.2.2 # 安装一个推荐的稳定版本，例如 3.2.2 rbenv global 3.2.2 # 设置为全局默认版本 rbenv rehash # 使新安装的ruby版本生效
- 检查 Ruby 版本:
  bash ruby -v
安装 Bundler： Bundler 是 Ruby 的依赖管理器，用于管理项目所需的 Gem。Rails 依赖于 Bundler。
bash gem install bundler
- 检查 Bundler 版本:
  bash bundle -v
安装 Rails Gem： 现在，你可以安装 Rails 本身作为 Gem。
bash gem install rails -v 7.0.8 # 安装一个特定版本，例如 7.0.8，避免安装最新的预发布版本 # 或者 gem install rails # 安装最新稳定版本
- 检查 Rails 版本:
  bash rails -v

注意： 确保你的系统中已经安装了数据库软件（如 SQLite3, PostgreSQL 或 MySQL）以及Node.js和Yarn（用于处理前端资产）。Rails 默认使用 SQLite3 作为开发数据库，安装 Ruby 时通常会包含 SQLite3 的支持。Node.js 和 Yarn 用于 Asset Pipeline 或 Propshaft 来处理 JavaScript 和 CSS。

2.2 创建你的第一个 Rails 应用

环境准备就绪后，就可以创建应用了。打开终端，切换到你想创建项目的目录下，然后运行：

bash rails new myapp

这条命令做了很多事情：

创建一个名为 myapp 的新目录。
在这个目录下生成一个完整的 Rails 应用骨架。
运行 bundle install 安装应用所需的所有 Gem（依赖）。

这个过程可能需要几分钟。完成后，进入新创建的项目目录：

bash cd myapp

现在，你可以启动 Rails 内置的开发服务器 Puma：

“`bash
rails server

或者简写为 rails s

“`

打开你的浏览器，访问 http://localhost:3000。如果一切顺利，你将看到 Rails 的欢迎页面 (“Yay! You’re on Rails!”)。恭喜你，你的第一个 Rails 应用已经跑起来了！

2.3 Rails 应用的目录结构

让我们简单看看 myapp 目录里的内容。理解这个结构对于后续开发非常重要：

app/: 存放应用的核心代码，遵循 MVC 模式。
- app/models/: 存放模型文件。
- app/views/: 存放视图文件。
- app/controllers/: 存放控制器文件。
- app/assets/: 存放前端静态资源（CSS, JavaScript, 图片）。
- app/helpers/: 存放视图助手方法。
- app/mailers/: 存放处理邮件发送的代码。
- app/jobs/: 存放处理后台任务的代码。
bin/: 存放可执行文件，如 rails, rake, bundle 等命令的封装。
config/: 存放应用的配置文件。
- config/routes.rb: 定义应用的URL路由。
- config/database.yml: 配置数据库连接。
- config/application.rb: 应用全局配置。
- config/environments/: 各个环境（development, test, production）的特定配置。
- config/initializers/: 应用启动时加载的初始化文件。
db/: 存放数据库相关文件。
- db/migrate/: 存放数据库迁移文件。
- db/schema.rb: 数据库模式（schema）的当前状态描述。
lib/: 存放自定义库或模块。
log/: 存放应用日志文件。
public/: 存放可以直接访问的静态文件（如 HTML, CSS, 图片，但通常通过 Asset Pipeline 处理）。
storage/: 存放 Active Storage 上传的文件。
test/: 存放自动化测试文件。
tmp/: 存放临时文件。
vendor/: 存放第三方代码（不推荐直接修改）。
Gemfile: 列出应用依赖的所有 Gem。
Gemfile.lock: 锁定 Gem 的具体版本，确保环境一致性。
README.md: 项目说明文件。

初看可能觉得复杂，但随着你开发深入，会发现这种结构非常有助于组织代码。

第三部分：Rails 核心组件详解

现在，我们将深入探讨 MVC 以及 Rails 中的其他重要组件。

3.1 路由 (Routing)

路由是 Rails 应用接收到用户请求后，决定将请求转发给哪个 Controller 的哪个 Action 的机制。路由定义在 config/routes.rb 文件中。

默认的 routes.rb 文件会包含一些注释和示例。最常见的路由定义方式是使用 resources 方法，它会为 RESTful 资源自动生成一套标准的路由（index, show, new, create, edit, update, destroy）：

“`ruby

config/routes.rb

Rails.application.routes.draw do
# 定义一个根路由（首页）
root “articles#index”

# 为 articles 资源生成所有标准的 RESTful 路由
resources :articles

# 你也可以自定义路由
# get “/about”, to: “pages#about”
# post “/contact”, to: “pages#contact”
end
“`

resources :articles 这行代码等价于生成了如下多条路由：

HTTP 方法	路径	对应的 Controller#Action	别名 Helper 方法 (用于生成URL)	作用
GET	`/articles`	`articles#index`	`articles_path`	列出所有文章
GET	`/articles/:id`	`articles#show`	`article_path(article)`	显示特定文章
GET	`/articles/new`	`articles#new`	`new_article_path`	显示创建表单
POST	`/articles`	`articles#create`	`articles_path`	创建新文章
GET	`/articles/:id/edit`	`articles#edit`	`edit_article_path(article)`	显示编辑表单
PATCH/PUT	`/articles/:id`	`articles#update`	`article_path(article)`	更新特定文章
DELETE	`/articles/:id`	`articles#destroy`	`article_path(article)`	删除特定文章

你可以通过运行 rails routes 命令查看当前应用定义的所有路由。理解路由是理解如何响应不同用户请求的基础。

3.2 控制器 (Controller)

控制器是继承自 ApplicationController 的 Ruby 类，位于 app/controllers/ 目录下。每个控制器类负责处理一组相关的请求。例如，ArticlesController 可能负责处理与文章相关的请求（显示文章列表、显示单篇文章、创建新文章等）。

控制器中的公共方法被称为 Action。当一个请求通过路由被匹配到某个控制器的一个 Action 时，Rails 会执行这个 Action 方法。

“`ruby

app/controllers/articles_controller.rb

class ArticlesController < ApplicationController
# GET /articles
def index
@articles = Article.all # 从数据库获取所有文章（与 Model 交互）
# Rails 会默认渲染 app/views/articles/index.html.erb
end

# GET /articles/:id
def show
@article = Article.find(params[:id]) # 根据 ID 查找文章
# Rails 会默认渲染 app/views/articles/show.html.erb
rescue ActiveRecord::RecordNotFound # 错误处理
render plain: “Article not found”, status: :not_found
end

# GET /articles/new
def new
@article = Article.new # 创建一个新文章对象（尚未保存）
# Rails 会默认渲染 app/views/articles/new.html.erb
end

# POST /articles
def create
@article = Article.new(article_params) # 使用安全参数创建文章
if @article.save # 如果保存成功（与 Model 交互）
redirect_to @article # 重定向到文章详情页
else
render :new, status: :unprocessable_entity # 保存失败，重新渲染表单并显示错误
end
end

# … 其他 Action: edit, update, destroy

private # 私有方法，只能在控制器内部使用

# 强参数 (Strong Parameters)：确保只有允许的参数才能被赋值给模型
def article_params
  params.require(:article).permit(:title, :body)
end

end
“`

在控制器中：

使用 @ 符号开头的变量（实例变量）会自动传递给对应的 View。
params 是一个哈希，包含从 URL、查询字符串或请求体中获取的参数。
redirect_to 方法用于重定向用户到另一个URL。
render 方法用于渲染指定的 View 模板。
before_action 等方法可以用于在 Action 执行前执行一些过滤操作（如用户认证、加载资源等）。
私有方法 article_params 展示了 Rails 的“强参数”机制，用于防止恶意赋值攻击。

3.3 模型 (Model) – Active Record

Model 负责处理数据和业务逻辑。在 Rails 中，Model 通常通过 Active Record 库实现，Active Record 是一个对象关系映射 (ORM) 系统。它将数据库表映射到 Ruby 类，将表的行映射到类的实例，将表的列映射到对象的属性。

创建 Model 通常通过生成器完成：

“`bash
rails generate model Article title:string body:text

或简写为 rails g model Article title:string body:text

“`

这条命令会生成一个 Model 文件 (app/models/article.rb) 和一个数据库迁移文件 (db/migrate/..._create_articles.rb)。

“`ruby

app/models/article.rb

class Article < ApplicationRecord
# 定义模型关联，例如一篇文章可能属于一个用户
# belongs_to :user

# 定义数据验证 (Validations)
validates :title, presence: true, length: { minimum: 5 }
validates :body, presence: true

# 定义回调 (Callbacks)，例如在保存前或后执行某些操作
# before_save :do_something

# 定义作用域 (Scopes)，用于定义常用的查询
# scope :published, -> { where(published: true) }
end
“`

“`ruby

db/migrate/…_create_articles.rb

class CreateArticles < ActiveRecord::Migration[7.0]
def change
create_table :articles do |t|
t.string :title
t.text :body

  t.timestamps # 添加 created_at 和 updated_at 时间戳列
end

end
end
“`

运行迁移以在数据库中创建表：

bash rails db:migrate

Active Record 为 Model 对象提供了丰富的数据库操作方法：

Article.all：获取所有文章。
Article.find(id)：根据 ID 查找文章。
Article.find_by(title: "...")：根据属性查找文章。
Article.where("...")：执行带条件的查询。
Article.new(...)：创建一个新的文章对象（尚未保存）。
article.save：保存文章对象到数据库。
article.update(...)：更新文章属性并保存。
article.destroy：从数据库中删除文章。

Active Record 的强大之处在于它用面向对象的方式封装了数据库操作，并提供了验证、关联等高级功能，极大地简化了数据处理。

3.4 视图 (View)

视图负责生成用户界面的内容，通常是 HTML。Rails 默认使用 ERB (Embedded Ruby) 模板语言，视图文件以 .html.erb 结尾，位于 app/views/ 目录下，并按控制器名称组织子目录（如 app/views/articles/）。

在 .html.erb 文件中，你可以混合使用 HTML 和 Ruby 代码：

<%= expression %>: 执行 Ruby 表达式，并将结果输出到 HTML。
<% code %>: 执行 Ruby 代码，但不输出结果（例如控制流语句）。
<%- code %>: 执行 Ruby 代码，但不输出结果，并去除行尾换行符。
<%# comment %>: Ruby 注释，不会出现在最终 HTML 中。

“`html+erb
<%# app/views/articles/index.html.erb %>

文章列表

<% @articles.each do |article| %>

<% end %>

标题	内容
<%= article.title %>	<%= article.body %>	<%= link_to "查看", article_path(article) %>	<%= link_to "编辑", edit_article_path(article) %>	<%= link_to "删除", article_path(article), method: :delete, data: { confirm: "确定删除吗?" } %>

<%= link_to “新建文章”, new_article_path %>
“`

这个例子展示了如何在 View 中使用 Ruby 迭代 @articles 集合，访问文章对象的属性，并使用 Rails 提供的 View Helpers（如 link_to）生成 HTML 链接。

View Helpers 位于 app/helpers/ 目录下，它们是一些 Ruby 方法，用于在视图中执行常见的任务，如格式化文本、生成表单元素、生成链接等。你可以编写自己的助手方法来复用视图逻辑。

布局文件（Layouts）通常位于 app/views/layouts/ 目录下（默认是 application.html.erb）。它们提供了页面共同的框架（如 HTML 头部、导航栏、页脚），并通过 <%= yield %> 将特定视图的内容嵌入其中。

3.5 数据库迁移 (Database Migrations)

数据库迁移是 Rails 提供的一种版本控制数据库模式（schema）的方式。它允许你用 Ruby 代码来定义数据库表的创建、修改、删除等操作，并将这些操作记录下来。这样，你就可以轻松地在不同环境（开发、测试、生产）中同步数据库结构，或者回滚到之前的版本。

迁移文件位于 db/migrate/ 目录下，文件名包含时间戳，以确保执行顺序。

使用生成器创建 Model 或 Scaffold 时会自动生成迁移文件。你也可以手动生成迁移来添加或删除表/列：

“`bash
rails generate migration AddPublishedToArticles published:boolean

或简写为 rails g migration AddPublishedToArticles published:boolean

“`

这会生成一个迁移文件，其中包含了添加 published 布尔类型列到 articles 表的代码。

运行迁移：

bash rails db:migrate # 执行所有待执行的迁移 rails db:rollback # 回滚最近一次迁移 rails db:migrate VERSION=... # 迁移到指定版本

迁移使得数据库模式的变更变得可追溯和管理，是团队协作和部署的重要工具。

3.6 Bundler 和 Gem

Bundler 是 Ruby 项目的依赖管理器。通过编辑项目根目录下的 Gemfile 文件，你可以声明项目依赖的所有 Gem。

“`ruby

Gemfile

source “https://fd.520196.xyz:443/https/rubygems.org”

git_source(:github) do |repo_name|
repo_name = “#{repo_name}/#{repo_name}” unless repo_name.include?(“/”)
“https://fd.520196.xyz:443/https/github.com/#{repo_name}.git”
end

主要的 rails gem

gem “rails”, “~> 7.0.8”

数据库适配器 (默认是 sqlite3)

gem “sqlite3”, “~> 1.4”

使用 PostgreSQL 或 MySQL 可以替换上面的 sqlite3

gem “pg”, “~> 1.1”

gem “mysql2”, “~> 0.5”

… 其他默认的 Rails Gem

开发环境和测试环境使用的 Gem

group :development, :test do
gem “debug”, platforms: %i[ mri mingw x64_mingw ]
end

只在开发环境使用的 Gem

group :development do
gem “annotate” # 添加模型/路由/等注释
gem “better_errors” # 更好的错误页面
end

只在测试环境使用的 Gem

group :test do
gem “rspec-rails” # RSpec 测试框架
end

生产环境使用的 Gem

group :production do
# 例如，用于部署到 Heroku
# gem “puma”
end
“`

编辑 Gemfile 后，运行 bundle install 命令，Bundler 会下载并安装所有声明的 Gem 及其依赖，并将安装的具体版本记录在 Gemfile.lock 文件中。

Rails 的 Gem 生态系统是其强大生产力的重要来源。你可以通过 Gem 添加各种功能，如用户认证 (Devise)、后台任务 (Sidekiq)、API 版本控制、图表生成等等。当需要某个功能时，通常可以先搜索是否有现成的 Gem 可用，而不是从头开始编写。

第四部分：进阶概念与后续学习

4.1 强参数 (Strong Parameters)

在 Rails 4 之后，为了增强安全性，控制器接收的 params 哈希默认是“不允许批量赋值”的。这意味着你不能直接将整个 params 哈希赋值给 Model 对象的属性（如 Article.new(params[:article])），因为用户可以通过恶意请求注入不希望修改的属性（如管理员权限字段）。

强参数机制要求你在控制器中明确指定允许哪些参数被赋值。这通过 require 和 permit 方法实现：

ruby private def article_params params.require(:article).permit(:title, :body, :published) # 明确允许 title, body, published 三个参数 end

然后在使用时调用这个方法：@article = Article.new(article_params)。这是 Rails 应用开发中一个重要的安全实践。

4.2 回调 (Callbacks)

Active Record Model 提供了丰富的回调机制，允许你在 Model 生命周期的特定事件发生时执行代码。例如：

before_save, after_save
before_create, after_create
before_update, after_update
before_destroy, after_destroy
after_find, after_initialize

“`ruby
class Article < ApplicationRecord
before_save :set_published_date

private
def set_published_date
if published_changed? && published? # 如果 published 状态从 false 变为 true
self.published_at = Time.current # 设置发布时间
end
end
end
“`

回调非常强大，但也需要谨慎使用，过多的回调可能使 Model 的行为变得复杂难以追踪。

4.3 关联 (Associations)

Active Record 简化了数据库表之间的关系处理。常见的关联类型有：

belongs_to：一个模型属于另一个模型（一对多关系中的“多”方）。
has_one：一个模型有一个关联模型（一对一关系）。
has_many：一个模型有多个关联模型（一对多关系中的“一”方）。
has_many :through：通过第三个模型建立多对多关系。
has_one :through：通过第三个模型建立一对一关系。
and_belongs_to_many：直接在两个表之间建立多对多关系（不常用，推荐 has_many :through）。

“`ruby

app/models/user.rb

class User < ApplicationRecord
has_many :articles # 一个用户有多篇文章
end

app/models/article.rb

class Article < ApplicationRecord
belongs_to :user # 一篇文章属于一个用户
end
“`

定义了关联后，你就可以通过关联对象访问数据：

“`ruby
user = User.find(1)
user.articles # 返回该用户发布的所有文章

article = Article.find(1)
article.user # 返回发布该文章的用户
“`

关联是构建复杂数据模型的基础。

4.4 测试 (Testing)

Rails 非常重视测试，并内置了 MiniTest 测试框架的支持（也可以方便地集成 RSpec 等其他框架）。

Rails 提供了不同类型的测试：

单元测试 (Unit Tests): 测试模型、独立模块等单元的代码逻辑。
功能测试 (Functional Tests): 测试控制器 Action 的响应，模拟用户请求和交互。
集成测试 (Integration Tests): 测试跨越多个控制器、模型的复杂用户流程。
系统测试 (System Tests): 使用 Capybara 等工具模拟浏览器行为，进行端到端测试。

测试文件位于 test/ 目录下。通过编写测试，可以确保代码的正确性，并在修改代码时快速发现引入的 Bug，提高代码质量和维护效率。

运行测试：

bash rails test # 运行所有测试

4.5 资产管道 (Asset Pipeline) 或 Propshaft

Rails 应用通常需要处理前端静态资源，如 CSS、JavaScript 和图片。早期版本使用 Asset Pipeline (Sprockets)，较新版本则使用 Propshaft。它们负责：

合并 (Concatenation): 将多个文件合并成一个文件，减少HTTP请求。
压缩/混淆 (Minification/Obfuscation): 减小文件体积。
编译 (Compilation): 编译 Sass/SCSS 到 CSS，CoffeeScript/ES6+ 到 JavaScript。
指纹 (Fingerprinting): 根据文件内容生成唯一文件名，用于缓存控制。

资源文件通常放在 app/assets/ 目录下，按类型（config, images, javascripts, stylesheets）组织。Rails 会在生产环境预编译这些资产，生成带有指纹的文件，并在视图中使用相应的助手方法（如 javascript_include_tag, stylesheet_link_tag, image_tag）引入。

4.6 环境 (Environments)

Rails 应用可以在不同的运行环境（Environment）下运行，默认有三个：

development (开发环境): 优化开发体验，代码变更自动加载，详细错误报告，不缓存，方便调试。配置文件在 config/environments/development.rb。
test (测试环境): 优化测试执行，缓存开启，数据库独立。配置文件在 config/environments/test.rb。
production (生产环境): 优化性能和安全性，缓存开启，代码预编译，错误信息精简。配置文件在 config/environments/production.rb。

你可以通过设置 RAILS_ENV 环境变量来指定运行环境，例如部署时通常设置为 production。

第五部分：将知识付诸实践

学习 Rails 最好的方式就是动手构建应用。你可以从简单的项目开始：

创建一个简单的博客应用： 实现文章的创建、编辑、删除、查看列表和单篇详情。这会让你熟悉路由、控制器、模型（带验证）、视图和数据库迁移。
添加用户认证： 使用 Devise Gem 为你的应用添加用户注册、登录、登出功能。你会学习如何集成第三方 Gem。
添加评论功能： 为文章添加评论，学习模型关联（一篇文章有多个评论，一个评论属于一篇文章和一位用户）和嵌套资源路由。
部署你的应用： 尝试将你的应用部署到 Heroku、Vercel（仅限API）、Render 或自己的服务器上，学习生产环境配置和部署流程。

在学习过程中，请善用 Rails 的官方文档（Guides）、API 文档，以及社区提供的各种教程和资源。rails generate 命令的 --help 选项可以查看生成器用法，rails console (或 rails c) 是一个交互式环境，可以用来测试 Model 和代码片段。

结论

初识 Ruby on Rails，你可能被它的速度和约定所震撼。Rails 确实是一个强大且高效的框架，它为 Web 开发提供了经过深思熟虑的结构和工具。MVC 模式、Active Record 的 ORM、智能的路由系统、强大的视图层以及庞大的 Gem 生态系统协同工作，让你能够专注于业务逻辑的实现，而不是底层基础设施的搭建。

作为开发者，理解 Rails 的核心哲学（CoC 和 DRY）以及 MVC 的工作原理是掌握它的钥匙。随着你深入学习，你会逐渐揭开那些“魔法”的表象，理解其背后是如何通过 Ruby 的元编程等特性实现的。

Rails 社区非常活跃友好，提供了丰富的学习资源。不要害怕提问，动手实践是最好的老师。从简单的例子开始，逐步挑战更复杂的功能，你会发现用 Rails 构建 Web 应用是一件充满乐趣和成就感的事情。

初识 Ruby on Rails：为开发者准备的快速指南

1.1 什么是 Ruby on Rails？

1.2 为什么选择 Rails？

1.3 核心架构：MVC

2.1 环境准备

2.2 创建你的第一个 Rails 应用

或者简写为 rails s

2.3 Rails 应用的目录结构

3.1 路由 (Routing)

config/routes.rb

3.2 控制器 (Controller)

app/controllers/articles_controller.rb

3.3 模型 (Model) – Active Record

或简写为 rails g model Article title:string body:text

app/models/article.rb

db/migrate/…_create_articles.rb

3.4 视图 (View)

文章列表

3.5 数据库迁移 (Database Migrations)

或简写为 rails g migration AddPublishedToArticles published:boolean

3.6 Bundler 和 Gem

Gemfile

主要的 rails gem

数据库适配器 (默认是 sqlite3)

使用 PostgreSQL 或 MySQL 可以替换上面的 sqlite3

gem “pg”, “~> 1.1”

gem “mysql2”, “~> 0.5”

… 其他默认的 Rails Gem

开发环境和测试环境使用的 Gem

只在开发环境使用的 Gem

只在测试环境使用的 Gem

生产环境使用的 Gem

4.1 强参数 (Strong Parameters)

4.2 回调 (Callbacks)

4.3 关联 (Associations)

app/models/user.rb

app/models/article.rb

4.4 测试 (Testing)

4.5 资产管道 (Asset Pipeline) 或 Propshaft

4.6 环境 (Environments)

发表评论 取消回复

发表评论取消回复