Ruby on Rails 指南 (v8.1.0)

这些是基于 v8.1.0 的 Rails 8.1 新指南。这些指南旨在让您立即高效地使用 Rails，并帮助您理解所有组件是如何协同工作的。

: Rails 指南也提供 Kindle 版本。; 标有此图标的指南目前正在编写中，不会出现在“指南索引”菜单中。尽管它们仍然有用，但可能包含不完整的信息甚至错误。您可以通过审阅它们并发布您的评论和更正来提供帮助。

从这里开始

Rails 入门: 安装 Rails 并创建您的第一个应用程序所需了解的一切。
安装 Ruby on Rails: 了解如何安装 Ruby 编程语言和 Ruby on Rails。

模型

Active Record 基础: Active Record 允许您的模型与应用程序的数据库进行交互。本指南将引导您开始使用 Active Record 模型和数据库持久化。
Active Record 迁移: Migrations 是 Active Record 的一项功能，允许您随着时间的推移演进数据库模式。Migrations 允许您使用 Ruby DSL 来描述表的更改，而不是用纯 SQL 编写模式修改。
Active Record 验证: 验证用于确保只有有效数据才能保存到数据库中。本指南教您如何使用 Active Record 的验证功能，在对象进入数据库之前验证其状态。
Active Record 回调: 回调使编写代码成为可能，这些代码将在对象被创建、更新、销毁等时运行。本指南教您如何利用 Active Record 对象的生命周期。
Active Record 关联: 在 Active Record 中，关联是两个 Active Record 模型之间的连接。本指南涵盖了 Active Record 提供的所有关联。
Active Record 查询接口: Active Record 提供了比使用原始 SQL 查找数据库记录更好的方法来执行相同的操作。本指南涵盖了使用 Active Record 从数据库检索数据的不同方法。
Active Model 基础: Active Model 允许您创建与 Action Pack 集成的纯 Ruby 对象，但不需要 Active Record 进行数据库持久化。Active Model 还有助于构建用于 Rails 框架之外的自定义 ORM。本指南为您提供了开始使用 Active Model 类所需的一切。

视图

Action View 概述: Action View 负责为 Web 响应生成 HTML。本指南提供了 Action View 的介绍。
Rails 中的布局和渲染: 本指南涵盖了 Action Controller 和 Action View 的基本布局功能，包括渲染和重定向、使用 content_for 块以及使用局部视图。
Action View 助手: Action View 提供了处理从格式化日期、链接到图像到清理和本地化内容的各种辅助方法。本指南介绍了一些更常见的 Action View 辅助方法。
Action View 表单助手: HTML 表单由于需要处理表单控件命名及其众多属性，可能会很快变得繁琐且难以维护。Rails 通过提供用于生成表单标记的视图辅助方法来消除这种复杂性。

控制器

Action Controller 概述: Action Controller 是 Rails 中 Web 请求的核心。本指南涵盖了控制器的工作原理以及它们如何融入应用程序的请求周期。主题包括在控制器动作中访问参数、使用会话和 cookie、控制器回调。
Action Controller 高级主题: 本指南涵盖了 Rails 应用程序中与控制器相关的许多高级主题，例如防止跨站请求伪造、HTTP 身份验证、数据流、处理异常、日志过滤等。
Rails 路由从外到内: Rails 路由器识别 URL 并将它们分派到控制器的动作。本指南涵盖了 Rails 路由的用户端功能。如果您想了解如何在自己的 Rails 应用程序中使用路由，请从这里开始。

其他组件

Active Support 核心扩展: Active Support 提供了 Ruby 语言扩展和实用程序。它丰富了 Ruby 语言，用于开发 Rails 应用程序以及 Ruby on Rails 本身。
Action Mailer 基础: 本指南为您提供了开始从应用程序发送电子邮件所需的一切，以及 Action Mailer 的许多内部原理。
Action Mailbox 基础: 本指南介绍了如何使用 Action Mailbox 接收电子邮件。
Action Text 概述: 本指南介绍了如何使用 Action Text 处理富文本内容。
Active Job 基础: Active Job 是一个用于声明后台作业并使它们在各种队列后端上运行的框架。本指南为您提供了开始创建、入队和执行后台作业所需的一切。
Active Storage 概述: Active Storage 便于将文件上传到云存储服务，转换上传并提取元数据。本指南涵盖了如何将文件附加到您的 Active Record 模型。
Action Cable 概述: Action Cable 将 WebSockets 与 Rails 应用程序的其余部分集成。它允许以与 Rails 应用程序其余部分相同的风格和形式用 Ruby 编写实时功能。本指南解释了 Action Cable 的工作原理以及如何使用 WebSockets 创建实时功能。

深入挖掘

Rails 国际化 (I18n) API: 本指南涵盖了如何为您的应用程序添加国际化。您的应用程序将能够将内容翻译成不同的语言，更改复数规则，为每个国家/地区使用正确的日期格式等。
测试 Rails 应用程序: 本指南探讨了如何在 Rails 中编写测试。它还涵盖了测试配置并比较了测试应用程序的方法。
调试 Rails 应用程序: 本指南介绍了如何调试 Rails 应用程序。它涵盖了实现此目的的不同方法以及如何理解代码“幕后”发生的事情。
配置 Rails 应用程序: 本指南涵盖了 Rails 应用程序的基本配置设置。
Rails 命令行: 有些命令对您日常使用 Rails 绝对至关重要。本指南涵盖了 Rails 提供的命令行工具。
资产管道: 资产管道指南解释了如何使用 Propshaft（一个处理基本资产管理任务的框架）。
在 Rails 中使用 JavaScript: 本指南解释了如何使用 import maps 或 jsbundling-rails 将 JavaScript 包含在 Rails 应用程序中，并涵盖了在 Rails 中使用 Turbo 的基础知识。
Rails 初始化过程: 正在进行中; 本指南解释了 Rails 初始化过程的内部原理。这是一份极其深入的指南，推荐给高级 Rails 开发人员。
自动加载和重新加载: 本指南记录了自动加载和重新加载常量的工作原理。
Active Support 仪器: 正在进行中; 本指南解释了如何使用 Active Support 中的仪器 API 来测量 Rails 和其他 Ruby 代码中的事件。
将 Rails 用于纯 API 应用程序: 本指南解释了如何有效地使用 Rails 开发 JSON API 应用程序。

部署到生产环境

调整部署性能: 本指南涵盖了部署生产 Ruby on Rails 应用程序的性能和并发配置。
Rails 缓存概述: 本指南是关于通过缓存加速 Rails 应用程序的介绍。
保护 Rails 应用程序安全: 本指南描述了 Web 应用程序中常见的安全问题以及如何使用 Rails 避免它们。
Rails 应用程序中的错误报告: 本指南介绍了管理 Ruby on Rails 应用程序中发生错误的方法。

高级 Active Record

Active Record 和 PostgreSQL: 正在进行中; 本指南涵盖了 Active Record 的 PostgreSQL 特有用法。
多数据库: 本指南涵盖了在您的应用程序中使用多个数据库。
Active Record 加密: 正在进行中; 本指南涵盖了使用 Active Record 加密您的数据库信息。
复合主键: 本指南是数据库表的复合主键介绍。

扩展 Rails

创建 Rails 插件的基础: 本指南涵盖了如何构建一个插件来扩展 Rails 的功能。
Rails on Rack: 本指南涵盖了 Rails 与 Rack 的集成以及与其他 Rack 组件的接口。
创建和自定义 Rails 生成器和模板: 本指南涵盖了向您的扩展添加全新生成器或为内置 Rails 生成器的元素提供替代方案（例如为脚手架生成器提供替代测试存根）的过程。
引擎入门: 正在进行中; 引擎可以被视为提供额外功能给其宿主应用程序的微型应用程序。在本指南中，您将学习如何创建自己的引擎并将其与宿主应用程序集成。
Rails 中的线程和代码执行: 正在进行中; 本指南描述了在 Rails 应用程序中直接处理并发时所需的注意事项和可用工具。

贡献

为 Ruby on Rails 做贡献: Rails 不是“别人的框架”。本指南涵盖了您可以参与 Rails 持续开发的各种方式。
API 文档指南: 本指南记录了 Ruby on Rails API 文档指南。
指南编写规范: 本指南记录了 Ruby on Rails 指南的编写规范。
安装 Rails 核心开发依赖项: 本指南涵盖了如何设置 Ruby on Rails 核心开发环境。

策略

维护策略: 当前支持的 Ruby on Rails 版本，以及何时发布新版本。

发布说明

升级 Ruby on Rails: 本指南提供了将您的应用程序升级到新版本 Ruby on Rails 时应遵循的步骤。
版本 8.1 - 2025 年 10 月: Rails 8.1 发布说明。
版本 8.0 - 2024 年 11 月: Rails 8.0 发布说明。
版本 7.2 - 2024 年 8 月: Rails 7.2 发布说明。
版本 7.1 - 2023 年 10 月: Rails 7.1 发布说明。
版本 7.0 - 2021 年 12 月: Rails 7.0 发布说明。
版本 6.1 - 2020 年 12 月: Rails 6.1 发布说明。
版本 6.0 - 2019 年 8 月: Rails 6.0 发布说明。
版本 5.2 - 2018 年 4 月: Rails 5.2 发布说明。
版本 5.1 - 2017 年 4 月: Rails 5.1 发布说明。
版本 5.0 - 2016 年 6 月: Rails 5.0 发布说明。
版本 4.2 - 2014 年 12 月: Rails 4.2 发布说明。
版本 4.1 - 2014 年 4 月: Rails 4.1 发布说明。
版本 4.0 - 2013 年 6 月: Rails 4.0 发布说明。
版本 3.2 - 2012 年 1 月: Rails 3.2 发布说明。
版本 3.1 - 2011 年 8 月: Rails 3.1 发布说明。
版本 3.0 - 2010 年 8 月: Rails 3.0 发布说明。
版本 2.3 - 2009 年 3 月: Rails 2.3 发布说明。
版本 2.2 - 2008 年 11 月: Rails 2.2 发布说明。