Rails Guides：按主题阅读 Ruby on Rails 官方指南，并切换到各个历史版本

首页：按主题分组的指南列表

首页标题为“Ruby on Rails Guides (v8.1.4)”，说明写着这些是基于 v8.1.4 的 Rails 8.1 新版指南，目标是让读者很快能上手 Rails，并理解各部分如何配合。截至 2026 年 10 月，首页显示的版本为 v8.1.4。

首页按主题分组。“Start Here”（从这里开始）下有 Getting Started with Rails（安装 Rails 并创建第一个应用）和 Install Ruby on Rails（安装 Ruby 语言和 Rails）两篇。“Models”（模型）下有 Active Record Basics、Active Record Migrations（用 Ruby 的 DSL 描述表结构变化，而不是直接写 SQL）、Active Record Validations（保存前校验对象状态）和 Active Record Callbacks 等。

Rails Guides 首页截图，顶部为 Rails 标志和 Version 下拉菜单，标题为 Ruby on Rails Guides (v8.1.4)，下方列出 Start Here 和 Models 两组指南

首页还有一段说明：标有施工图标的指南仍在编写中，不会出现在 Guides Index 菜单里，内容可能不完整，甚至存在错误，读者可以提交评论或更正。

版本切换

首页的 Version 下拉菜单依次列出 Edge、8.0、7.2、7.1、7.0、6.1、6.0、5.2、5.1、5.0、4.2、4.1、4.0、3.2、3.1、3.0 和 2.3。选择某个版本后，页面会切换到该版本的指南。

维护旧项目的读者可以在这里切换到项目所用的版本，再阅读对应的指南。

以“错误报告”指南为例

“Error Reporting in Rails Applications”讲解如何在 Rails 应用中管理错误。页面开头列出读完后能够掌握的两件事：使用 Rails 的错误报告器（error reporter）捕获并上报错误，以及为自己的错误报告服务创建自定义订阅者（subscriber）。

指南的第一章“Error Reporting”说明，Rails 的错误报告器提供了一种标准方式，用来收集应用中发生的错误，并把它们上报到选定的服务或位置，例如 Sentry 这样的监控服务。它的目的是替代到处重复的错误处理代码。

Rails 错误报告指南截图，页面标题为 Error Reporting in Rails Applications，左侧 Chapters 列出 Error Reporting 下的订阅、使用错误报告器、报告选项、全局设置上下文、按错误类过滤和关闭通知等小节，正文中有两段 Ruby 代码示例

指南的目录中，第一章之后还有“Error-reporting Libraries”（错误报告库）一章。

阅读建议

读者如果刚开始学习 Rails，可以从“Start Here”里的安装与入门指南开始，再进入 Active Record 相关的模型指南。遇到具体的功能问题，例如错误处理，可以直接跳到对应的指南，并先确认页面顶部版本与自己项目一致。