如何在 Windows 上逐步安装 Ruby

最后更新： 25/06/2025
作者： 艾萨克
  • 有几种方法可以安装 Ruby Windows其中 RubyInstaller 是最简单、最完整的选项。
  • 正确设置您的环境（Node.js、Yarn、SQLite 和 DevKit）是避免在安装 gem 或 Rails 等框架时出现问题的关键。
  • 版本和依赖关系管理对于跨项目工作和避免安装之间的冲突至关重要。

红宝石

你想开始 Windows PC 上的 Ruby 你还不知道如何开始吗？别担心，只要你遵循清晰的指南，一步步讲解，并避免最常见的问题，一切其实并不复杂。此外，如果你已经阅读过多个教程，发现每个教程的流程都不同（或者重要事项没有明确说明），那么这里总能找到解决方案。 全面解释 它不需要复杂的技术细节，就能将所有可用的相关信息汇集在一起​​，并以简单、有条理和最新的方式呈现给您。

我们将详细介绍在 Windows 上安装 Ruby 所需的一切知识，无论您是编写自己的脚本、使用 Ruby on Rails 等框架进行开发，还是只是从零开始学习这门语言。请注意，我们还会提供一些实用技巧，帮助您避免常见错误，并从一开始就优化您的开发环境。

为什么要在 Windows 上安装 Ruby 以及有哪些可用选项？

Ruby 是一种编程语言 编程 用途广泛且易于学习，非常适合编程新手和寻求强大灵活工具的专业人士。虽然它更常用于系统 Linux 或 macOS，越来越多的开发人员选择 Windows，尤其是使用像 Ruby 安装程序 从而简化流程。

由于 Ruby 安装程序在 Windows 上安装 Ruby 比以往任何时候都更容易，因为它包含了您立即开始使用所需的一切。但是，对于那些希望管理多个 Ruby 版本或需要针对特定​​项目自定义安装的人来说，还有其他方法，例如版本管理器、 comandos 并手动编译源代码。

使用的最大优点之一 Ruby 安装程序 它整合了环境 系统2，这使得安装原生 gem 和依赖项变得更容易，从而可以处理复杂的项目，例如 Ruby on Rails 没有额外的并发症。

工具和先决条件

红宝石

在开始安装 Ruby 之前，最好先在计算机上安装一些基本工具：

  • Git： 对于管理您的项目和从 GitHub 等在线存储库下载源代码非常有用。
  • 文本编辑器： Atom、VS Code 或 Sublime Text 是编辑 Ruby 代码的不错选择。
  • Node.js 和 Yarn： 如果您计划使用 Ruby on Rails 或 JavaScript 生态系统中的现代工具，则这是必需的。
  • SQLite： 如果您正在启动 Rails 项目，建议使用它，因为它通常是默认数据库系统。
  Windows 365 Link：从云端运行 Windows 11 的迷你 PC

如果您还没有任何这些物品，请不要担心，因为下面我们将介绍如何轻松安装和配置它们。

步骤1：在Windows上安装Git

Git 对于任何现代开发人员来说都是必不可少的。要在 Windows 上安装它，只需访问 Git 官方网站 (https://git-scm.com/download/win)，下载与您的系统（通常为 64 位）对应的安装程序，然后按照向导操作。在安装过程中，您可以选择保留默认选项 吉特·巴什（Git Bash） 作为模拟器 终端完成后，您可以打开 Git Bash 并通过运行以下命令检查一切是否正常 git – 版本.

第 2 步：下载并使用 RubyInstaller

在 Windows 上安装 Ruby 最推荐和最常用的方法是通过 Ruby 安装程序，一个集成了解释器和开发必备组件的官方工具。

获取最新版本：

  • 前往 RubyInstaller 官方网站： https://rubyinstaller.org/
  • 下载最新的安装程序，寻找包含以下内容的版本 开发套件。例如：“Ruby+Devkit 3.xx (x64)”。
  • 运行安装程序，接受许可协议，然后选择将 Ruby 添加到 Windows PATH 变量。这样您就可以更轻松地从任何终端使用 Ruby。
  • 在最后一步中，请确保保留所选的选项 安装MSYS2和必要的开发工具完成后，终端将打开并运行带有多个选项的 MSYS2 自动配置；选项 3 通常涵盖大多数用户所需的所有设置。

要检查 Ruby 是否已正确安装，请打开 Git Bash 或任何终端并运行 ruby -v如果一切顺利，您将在屏幕上看到已安装的版本。

步骤3：安装Ruby DevKit并配置环境

El 的devkit 它对于编译一些需要原生组件的 gem 至关重要。如果您已经安装了带有 +Devkit 软件包的 Ruby，通常已经拥有了所需的一切。但是，如果您需要手动安装它：

  • 从 RubyInstaller 网站下载 DevKit 包。
  • 运行安装程序并将文件解压到一个文件夹，例如“C:\DevKit”。
  • 打开命令窗口 (CMD.exe），导航到 DevKit 文件夹并运行：
> chdir C:\DevKit > ruby​​ ​​dk.rb init > ruby​​ ​​dk.rb install

步骤 4：安装和配置其他组件（Node.js、Yarn 和 SQLite）

当你计划使用 Ruby on Rails 创建 Web 项目时，你还需要 Node.js y 纱 管理 JavaScript 资源，以及 SQLite 如果您使用默认的 Rails 配置。

  • 节点.js： 去吧 节点js.org下载推荐的 LTS 版本并按照步骤操作。安装过程中，如果出现提示，请务必选择安装其他工具的选项。
  • 纱： 从下载安装程序 Yarn官方网站 并按照屏幕上的步骤进行操作。
  • SQLite： 下载文件 sqlite-dll-win64-x64-XXXXXX.zip y sqlite-工具-win32-x86-XXXXXX.zip 从官方网站下载，解压到文件夹中 C：\ WINDOWS \ System32 以便它们可以作为全局命令访问。
  7 个最佳儿童教育项目

通过在终端中运行命令来确认一切正常 节点-v, 纱线 y sqlite3 –版本您应该会看到安装的版本没有任何问题。

第5步：验证Ruby安装

为了确保 Ruby 完全正常运行，请打开终端并输入：

ruby -v

你应该可以看到已安装的版本。你也可以测试一下 gem 的安装情况，例如：

宝石安装捆绑器

如果一切顺利，您的环境已准备就绪。如果您收到任何错误消息，请检查您是否已将 Ruby 添加到 PATH 变量并完成 MSYS2 安装。

步骤 6：安装 Rails 和您的第一个 gem

下一步通常是安装 轨，Ruby 生态系统中最具标志性的框架。为此，只需在终端中运行以下命令：

宝石安装导轨

安装可能需要几分钟，因为需要下载并编译许多依赖项。完成后，请使用以下命令验证安装：

导轨-v

除了 Rails 之外，强烈建议安装 邦德勒 （尽管它通常会自动安装）。Bundler 是负责管理 Ruby 项目中其余依赖项的 gem：

宝石安装捆绑器

创建并启动您的第一个 Ruby on Rails 项目

如果您想更进一步检查一切是否正常工作，您可以创建您的第一个 Rails 项目：

rails new my_test_app

当该过程完成后，导航到新目录并启动服务器：

cd my_test_app rails 服务器

打开浏览器并访问 http://localhost:3000您应该会看到 Rails 欢迎屏幕，这意味着您已在 Windows 计算机上正确安装和配置了 Ruby 和所有组件。

不要忘记，您可以通过按 按Ctrl + C 在终端。

版本管理器：如何管理多个 Ruby 安装

如果您需要处理具有不同 Ruby 版本要求的不同项目（例如，旧应用程序和新创建的应用程序），则 Windows 有特定的版本管理器，例如 适用于 Windows 的 rbenv （适用于 PowerShell的）或者 乌鲁，允许在版本之间轻松切换，并且设计为本地集成。

其他非常受欢迎的经理例如 asdf-vm y 红宝石 他们往往更注重环境 UNIX，但如果您有经验，您也可以在 Windows 上使用它们，但需进行一定的调整。

  如何在 Microsoft Teams 中更改您的姓名：分步说明

从源代码手动安装和编译 Ruby

在大多数情况下，通过 RubyInstaller 安装 Ruby 已经足够并且节省时间，但是如果您有非常具体的需求（例如，您想要特定的版本，需要自定义编译选项，或者只是想了解该过程如何工作），您可以通过编译源代码来安装 Ruby。

  1. 从 Ruby 官方网站 (ruby-lang.org/es/downloads/).
  2. 解压包并按照其中的说明进行编译（可能需要额外的工具，如 Make、GCC 等，您可以通过 MSYS2 安装）。
  3. 默认情况下，二进制文件将安装在 C:\Ruby 或您在安装过程中选择的文件夹。

此方法通常仅推荐高级用户或非常特定的开发环境使用，因为它需要更多的技术知识并且可能导致更多的兼容性问题。

常见错误和实用技巧

在 Windows 上安装或使用 Ruby 时，您可能会遇到一些典型错误：

  • PATH 的问题： 如果“ruby”未被识别为命令，请检查安装文件夹是否正确添加到 PATH 环境变量中。
  • 安装原生 gem 时出错： 确保您已正确配置和更新 DevKit 或 MSYS2。
  • 版本冲突： 如果您正在处理多个项目，请使用版本管理器（如 Windows 的 rbenv 或 uru）以避免混淆。
  • Rails 依赖问题： 在启动新的 Rails 项目之前，请确认您拥有正确版本的 Node.js、Yarn 和 SQLite。

如果您在任何时候发现自己陷入困境，请记住官方文档（ruby-lang.org) 和专业论坛可以快速为您提供帮助。此外，您还可以找到西班牙语和英语的社区帮助。

如果我想安装多个工具和管理器怎么办？

许多高级用户会根据项目情况使用第三方工具来管理多个 Ruby 版本。这些管理器虽然在 Windows 上尚未得到官方支持，但仍然非常有用：

  • 适用于 Windows 的 rbenv： 适应rbenv，兼容PowerShell中的命令行。
  • uru: 轻量级、易于配置的跨平台管理器。

如果你主要在 UNIX 环境中工作，管理人员喜欢 asdf-vm o 红宝石 可能更可取，但在 Windows 上，最实用的通常是坚持使用 RubyInstaller，如果有的话，还有 uru。

发表评论