Ruby on Rails 入门指南 – wiki词典

作者： /

Ruby on Rails 入门指南

引言

Ruby on Rails（简称 Rails）是一个基于 Ruby 语言开发的开源 Web 应用程序框架。它以其高效的开发速度、优雅的代码结构和“约定优于配置”（Convention over Configuration）的设计哲学而闻名。Rails 遵循“不要重复自己”（Don’t Repeat Yourself – DRY）的原则，旨在通过简化常见的开发任务，让开发者能够用更少的代码实现更多的功能。本指南将带你从零开始，踏上 Ruby on Rails 的学习之旅。

1. 前提条件

在开始安装 Ruby on Rails 之前，请确保您的系统满足以下基本要求：

  • Ruby: Rails 是用 Ruby 编写的，因此必须先安装 Ruby。推荐使用 Ruby 3.2 或更高版本以获得最佳兼容性和性能。
  • RubyGems: Ruby 的包管理器，通常随 Ruby 一起安装，用于管理和安装 Ruby 库（Gem）。
  • Node.js 和 Yarn: 用于处理前端资产，例如 JavaScript 编译和依赖管理。
  • Git: 版本控制系统，对于任何软件开发项目都是必不可少的。
  • SQLite3: Rails 默认使用的轻量级关系型数据库，非常适合开发和测试环境。

2. 安装 Ruby

推荐使用 Ruby 版本管理工具来安装和管理 Ruby，因为这可以帮助您在同一台机器上轻松切换和管理多个 Ruby 版本。常见的工具包括 RVM (Ruby Version Manager) 和 rbenv。

  • macOS/Linux:
    访问 ruby-lang.org 或相关版本管理工具的官方网站，获取针对您操作系统的详细安装说明。例如，使用 rbenv 的基本步骤可能如下：
    bash
    git clone https://github.com/rbenv/rbenv.git ~/.rbenv
    echo 'eval "$(~/.rbenv/bin/rbenv init - bash)"' >> ~/.bashrc # 或 ~/.zshrc
    exec $SHELL
    rbenv install 3.3.0 # 安装最新版本或您需要的版本
    rbenv global 3.3.0
  • Windows:
    对于 Windows 用户，可以考虑使用 RubyInstaller for Windows，它提供了一个简单易用的安装程序，包含了 RubyGems 和其他必要的开发工具。

安装完成后，通过运行以下命令验证 Ruby 是否成功安装：

bash
ruby -v

您应该会看到类似 ruby 3.3.0 (2023-12-25 revision 51e60759d0) [x64-mingw-ucrt] 的输出。

3. 安装 Rails

一旦 Ruby 安装完毕，您就可以使用 RubyGems 来安装 Rails 框架。

bash
gem install rails

这个命令将安装最新稳定版本的 Rails 及其所有依赖项。这个过程可能需要一些时间，具体取决于您的网络速度。

安装完成后，验证 Rails 是否成功安装：

bash
rails -v

如果显示类似 Rails 7.1.3.2 或更高版本，则表示 Rails 已成功安装在您的系统上。

4. 创建第一个 Rails 应用程序

使用 rails new 命令可以快速生成一个新的 Rails 应用程序骨架。

bash
rails new my_first_app

将 my_first_app 替换为您想要的项目名称。这个命令将创建一个名为 my_first_app 的新目录，并在其中设置好所有必要的文件和目录结构，包括 MVC 目录、数据库配置、测试文件等。

创建完成后，进入您新创建的应用程序目录：

bash
cd my_first_app

5. 运行 Rails 服务器

在应用程序目录中，您可以启动 Rails 的内置 Web 服务器（Puma）。

bash
rails server

或者简写为：

bash
rails s

服务器启动后，您将在命令行中看到一些输出，指示服务器正在监听的端口。通常，您可以在浏览器中访问 http://localhost:3000 来查看您的第一个 Rails 应用程序。您会看到一个默认的欢迎页面，这标志着您的 Rails 应用已成功运行。

6. 理解 Rails 的核心概念：MVC

Rails 的核心是其对模型-视图-控制器（Model-View-Controller – MVC）架构模式的实现。理解 MVC 对于开发 Rails 应用程序至关重要：

  • 模型 (Model): 负责处理应用程序的数据逻辑和与数据库的交互。模型是业务规则的载体，负责数据的验证、存储、检索和更新。
  • 视图 (View): 负责用户界面的呈现。视图从控制器接收数据，并以用户友好的方式显示它们（通常是 HTML、XML 或 JSON）。
  • 控制器 (Controller): 处理用户请求、与模型交互并选择合适的视图来响应。控制器是应用程序的“大脑”，负责协调模型和视图之间的通信。当用户在浏览器中发起请求时，请求会首先到达控制器。

结语

恭喜您！您已经成功安装了 Ruby on Rails 并创建了您的第一个应用程序。这仅仅是 Rails 世界的开始。接下来，您可以继续学习如何创建模型、定义数据库关系、编写控制器动作、设计视图模板、添加路由以及使用 Rails 提供的丰富功能来构建功能强大的 Web 应用程序。祝您学习愉快，编码顺利！

滚动至顶部