Ruby on Rails 指南 (v8.0.0)

这些是基于 v8.0.0 的 Rails 8.0 的新指南。这些指南旨在让您立即使用 Rails 提高生产力，并帮助您了解所有部分如何协同工作。

早期版本的指南：Rails 7.1、Rails 7.0、Rails 6.1、Rails 6.0、Rails 5.2、Rails 5.1、Rails 5.0、Rails 4.2、Rails 4.1、Rails 4.0、Rails 3.2、Rails 3.1、Rails 3.0 和 Rails 2.3。

: Rails 指南也适用于 Kindle。; 带有此图标的指南目前正在编写中，不会在指南索引菜单中提供。虽然仍然有用，但它们可能包含不完整的信息甚至错误。您可以通过查看它们并发布您的评论和更正来提供帮助。

从这里开始

Rails 入门: 安装 Rails 并创建第一个应用程序所需的一切。

模型

Active Record 基础: Active Record 允许您的模型与应用程序的数据库交互。本指南将帮助您开始使用 Active Record 模型和数据库持久性。
Active Record 迁移: 迁移是 Active Record 的一项功能，它允许您随着时间的推移演变数据库模式。与其用纯 SQL 编写模式修改，迁移允许您使用 Ruby DSL 来描述对表的更改。
Active Record 验证: 验证用于确保仅将有效数据保存到您的数据库中。本指南教您如何在使用 Active Record 的验证功能之前验证对象的 state，然后再将其放入数据库。
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 还帮助构建自定义 ORM 供 Rails 框架之外使用。本指南提供您开始使用 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、数据流以及处理请求引发的异常，以及其他主题。
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 应用程序: 本指南介绍了 Web 应用程序中的常见安全问题以及如何使用 Rails 避免这些问题。
Rails 应用程序中的错误报告: 本指南介绍了如何管理 Ruby on Rails 应用程序中发生的错误。
调试 Rails 应用程序: 本指南介绍了如何调试 Rails 应用程序。它介绍了实现此目标的不同方法以及如何了解代码“幕后”发生的事情。
配置 Rails 应用程序: 本指南介绍了 Rails 应用程序的基本配置设置。
Rails 命令行: 有一些命令对于您日常使用 Rails 至关重要。本指南介绍了 Rails 提供的命令行工具。
资产管道: 资产管道提供了一个框架来连接和缩小或压缩 JavaScript、CSS 和图像资产。它还增加了以其他语言和预处理器（如 CoffeeScript、Sass 和 ERB）编写这些资产的能力。
在 Rails 中使用 JavaScript: 本指南解释了如何使用导入映射或 jsbundling-rails 将 JavaScript 包含在 Rails 应用程序中，并介绍了在 Rails 中使用 Turbo 的基础知识。
Rails 初始化过程: 正在进行中; 本指南解释了 Rails 初始化过程的内部机制。这是一份极其深入的指南，推荐给高级 Rails 开发人员。
自动加载和重新加载: 本指南记录了自动加载和重新加载常量的运作方式。
使用 Rails 进行缓存：概述: 本指南介绍了如何使用缓存来加快 Rails 应用程序的速度。
Active Support Instrumentation: 正在进行中; 本指南解释了如何在 Active Support 内部使用 Instrumentation API 来衡量 Rails 和其他 Ruby 代码内部的事件。
将 Rails 用于仅 API 应用程序: 本指南解释了如何有效地使用 Rails 开发 JSON API 应用程序。
调整部署性能: 本指南介绍了用于部署生产 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 应用程序模板: 正在进行中; 应用模板是简单的 Ruby 文件，包含 DSL，用于向新创建的 Rails 项目或现有 Rails 项目添加 gems、初始化器等。
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.0 - ?: 正在进行中; 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 的发行说明。