安装 Ruby on Rails 指南

本指南将引导您在操作系统上安装 Ruby 编程语言和 Rails 框架。

虽然您的操作系统可能预装了 Ruby，但它通常已过时且无法升级。使用版本管理器（例如 Mise）可以安装最新的 Ruby 版本，为每个应用程序使用不同的 Ruby 版本，并在新版本发布时轻松升级。

或者，您可以使用开发容器在不直接在机器上安装 Ruby 或 Rails 的情况下运行 Rails。请参阅开发容器入门指南以了解更多信息。

1. 选择您的操作系统

根据您使用的操作系统，遵循相应章节的说明

macOS
Ubuntu
Windows

任何以美元符号 $ 开头的命令都应在终端中运行。

1.1. 在 macOS 上安装 Ruby

您需要 macOS Catalina 10.15 或更高版本才能遵循这些说明。

对于 macOS，您需要 Xcode 命令行工具和 Homebrew 来安装编译 Ruby 所需的依赖项。

打开终端并运行以下命令

# Install Xcode Command Line Tools
$ xcode-select --install

# Install Homebrew and dependencies
$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
$ echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc
$ source ~/.zshrc
$ brew install openssl@3 libyaml gmp rust

# Install Mise version manager
$ curl https://mise.run | sh
$ echo 'eval "$(~/.local/bin/mise activate)"' >> ~/.zshrc
$ source ~/.zshrc

# Install Ruby globally with Mise
$ mise use -g ruby@3

1.2. 在 Ubuntu 上安装 Ruby

您需要 Ubuntu Jammy 22.04 或更高版本才能遵循这些说明。

打开终端并运行以下命令

# Install dependencies with apt
$ sudo apt update
$ sudo apt install build-essential rustc libssl-dev libyaml-dev zlib1g-dev libgmp-dev git

# Install Mise version manager
$ curl https://mise.run | sh
$ echo 'eval "$(~/.local/bin/mise activate)"' >> ~/.bashrc
$ source ~/.bashrc

# Install Ruby globally with Mise
$ mise use -g ruby@3

1.3. 在 Windows 上安装 Ruby

适用于 Linux 的 Windows 子系统 (WSL) 将为在 Windows 上进行 Ruby on Rails 开发提供最佳体验。它在 Windows 中运行 Ubuntu，这使您可以在接近生产服务器运行环境的环境中工作。

您需要 Windows 11 或 Windows 10 版本 2004 及更高版本（内部版本 19041 及更高版本）。

打开 PowerShell 或 Windows 命令提示符并运行

$ wsl --install --distribution Ubuntu-24.04

在安装过程中可能需要重新启动。

安装完成后，您可以从“开始”菜单打开 Ubuntu。在提示时输入 Ubuntu 用户的用户名和密码。

然后运行以下命令

# Install dependencies with apt
$ sudo apt update
$ sudo apt install build-essential rustc libssl-dev libyaml-dev zlib1g-dev libgmp-dev

# Install Mise version manager
$ curl https://mise.run | sh
$ echo 'eval "$(~/.local/bin/mise activate bash)"' >> ~/.bashrc
$ source ~/.bashrc

# Install Ruby globally with Mise
$ mise use -g ruby@3

2. 验证 Ruby 安装

Ruby 安装完成后，您可以通过运行以下命令来验证它是否正常工作

$ ruby --version
ruby 3.3.6

3. 安装 Rails

Ruby 中的“gem”是库或 Ruby 程序的自包含包。我们可以使用 Ruby 的 gem 命令从 RubyGems.org 安装最新版本的 Rails 及其依赖项。

运行以下命令以安装最新 Rails 并使其在终端中可用

$ gem install rails

要验证 Rails 是否正确安装，请运行以下命令，您应该会看到打印出的版本号

$ rails --version
Rails 8.0.0

如果找不到 rails 命令，请尝试重新启动终端。