48、Rails 源代码探索与 Ruby、Rails 安装指南

Rails 源代码探索与 Ruby、Rails 安装指南

1. Rails 在线 API 文档导航

在 api.rubyonrails.org 上，其可用文档布局支持多种浏览方式，取决于你的兴趣点。在屏幕左侧有三个框架，对应以下三类信息，你可以直接从网站顶层获取它们的详细描述：
- Rails 框架中的文件 ：滚动可用文档的文件列表，你会看到 ActiveRecord、ActionPack 和各种支持库的构建块。选择一个文件，会显示其相关信息，包括完整路径（去掉 vendor/rails 部分后，与安装目录下的某个路径名称匹配）、最后修改日期以及该文件所需加载的所有文件。例如 vendor/rails/actionpack/lib/action_controller/base.rb，能让你一眼看出运行该文件需要加载的内容。不过，浏览这类元信息的趣味性和实用性有限，但在需要了解文件加载方式时，查看这里可能比翻阅文件更快。
- 框架中定义的类 ：左侧从上往下数第二个框架列出了 Rails 框架中定义的所有类，点击任何一个类可获取其相关信息，这是文档的核心部分。以 ActiveRecord::Associations::ClassMethods 为例，点击其链接，右侧框架会显示该类的页面。页面顶部会显示该类定义所在的文件，要注意 Ruby 类和模块可以在多个文件中重新打开并扩展定义，有些类和模块的文档会列出多个包含其源代码的文件，点击这些文件可查看每个文件的信息页面。此外，还会显示该类的父类（对于模块则不显示，因为模块没有与类相同的继承关系）。在这个框架中，通常会看到以下内容：
- 类或模块的描述和使用信息
-