异常教程

Ruby 安装 – Windows（超详细）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战(已更新的所有项目都能学习) / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

  • 新开坑项目:《Spring AI 项目实战》 正在持续爆肝中，基于 Spring AI + Spring Boot 3.x + JDK 21...， 点击查看 ;
  • 《从零手撸：仿小红书（微服务架构）》 已完结，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;演示链接： http://116.62.199.48:7070 ;
  • 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 100w+ 字，讲解图 4013+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3700+ 小伙伴加入学习 ，欢迎点击围观

前言

在编程领域，Ruby 是一门以简洁优雅著称的动态语言，它凭借 Rails 框架在 Web 开发中占据重要地位。无论是构建个人博客、电商系统，还是尝试机器学习项目，掌握 Ruby 都能为开发者打开一扇新世界的大门。然而，对于编程初学者而言，安装和配置开发环境往往是第一道门槛。本文将系统性地讲解 Ruby 安装 – Windows 的全流程，通过分步骤指导和直观案例，帮助读者快速搭建稳定的 Ruby 开发环境。

安装前的准备

硬件与系统要求

Ruby 对硬件资源需求较低，但建议使用 Windows 10 或更高版本 系统，以确保兼容性。若使用虚拟机或旧版系统，需提前检查官方文档的兼容性说明。

选择安装方式

Ruby 安装主要有两种途径：

  1. 直接安装 Ruby 解释器：适合对版本有明确需求或熟悉命令行工具的开发者。
  2. 通过包管理器安装：如使用 RubyInstaller 或 Chocolatey，适合追求便捷性的用户。

安装方式对比表

方法优点缺点
RubyInstaller图形化界面，步骤直观需手动配置环境变量
Chocolatey自动化安装，支持版本管理需预先安装包管理器
从源码编译完全自定义配置对系统要求高，耗时较长

使用 RubyInstaller 安装 Ruby

第一步：下载安装包

访问 RubyInstaller 官网 ，根据系统架构（32 位或 64 位）选择对应版本。推荐选择 MSI 安装程序，因其兼容性更佳。

下载页面关键配置说明

  • Development Kit（DK）：建议勾选，用于编译依赖 C 语言的 Ruby 模块。
  • Add Ruby executables to PATH：勾选后会自动配置环境变量，减少后续步骤。
choco install ruby -y --version=3.2.2

第二步：执行安装

  1. 运行下载的 .msi 文件，点击 Next。
  2. 在 Select Components 界面，确认勾选 Add Ruby executables to PATH，以便全局调用 ruby 命令。
  3. 完成安装后，系统会提示是否安装 Development Kit。若未选择，可通过后续步骤手动安装。

配置 Development Kit（DK）

安装步骤

  1. 从 RubyInstaller 官网 下载对应 Ruby 版本的 DK 包。
  2. 解压后打开命令行工具，进入解压目录： 
    cd path\to\devkit
  3. 初始化 DK 并指定目标路径： 
    ruby dk.rb init
  4. 验证配置并安装： 
    ruby dk.rb review  
ruby dk.rb install

DK 的作用比喻

可将 DK 理解为一座桥梁，它连接 Ruby 代码与底层系统资源（如文件操作、网络请求）。若缺少 DK，安装某些 Gem（Ruby 的包管理单元）时会出现编译错误。

验证安装与环境检查

检查 Ruby 版本

打开命令行工具，输入以下命令：

ruby -v

若显示类似 ruby 3.2.2p128 的输出，说明安装成功。

测试环境变量配置

在任意目录执行：

where ruby

若返回 Ruby 安装路径（如 C:\Ruby32\bin\ruby.exe），则环境变量已正确配置。

运行第一个 Ruby 程序

创建 hello.rb 文件，输入以下代码：

puts "Hello Ruby World!"

通过命令行执行：

ruby hello.rb

成功输出后，说明开发环境已就绪。

进阶配置：多版本管理与工具链

使用 RVM 或 rbenv 管理 Ruby 版本

对于需要同时管理多个 Ruby 版本的开发者，推荐使用 rbenv：

  1. 安装 Git（若未安装）： 
    choco install git -y
  2. 克隆 rbenv 仓库： 
    git clone https://github.com/rbenv/rbenv.git ~/.rbenv
  3. 将以下内容添加到 ~/.bashrc 或 ~/.zshrc： 
    export PATH="$HOME/.rbenv/bin:$PATH"  
eval "$(rbenv init -)"
  4. 重启终端并安装 Ruby 版本： 
    rbenv install 3.2.2  
rbenv global 3.2.2

安装常用开发工具

安装 bundler 管理依赖

gem install bundler

配置代码编辑器（以 VS Code 为例）

  1. 安装 Ruby 扩展：Ruby 和 Ruby Solargraph。
  2. 配置 launch.json 支持调试： 
    {  
  "version": "0.2.0",  
  "configurations": [  
    {  
      "type": "ruby",  
      "request": "launch",  
      "name": "Launch by Ruby",  
      "program": "${file}"  
    }  
  ]  
}

常见问题与解决方案

问题 1：ruby 命令未找到

可能原因

  • 环境变量未正确配置。
  • 安装路径包含空格或特殊字符。

解决方案

  1. 手动添加环境变量：
    • 打开 系统属性 > 高级系统设置 > 环境变量。
    • 在 Path 变量中添加 Ruby 的 bin 目录路径（如 C:\Ruby32\bin）。

问题 2：Gem 安装失败（权限问题）

解决方案

通过管理员权限运行命令行工具，或修改 Gem 缓存目录：

gem install <gem-name> --user-install

问题 3：Development Kit 编译失败

可能原因

  • DK 版本与 Ruby 不匹配。

解决方案

重新下载对应 Ruby 版本的 DK，并在安装时指定正确路径：

ruby dk.rb init --force

结论

通过本文的分步指南，读者应已掌握 Ruby 安装 – Windows 的核心步骤，并能解决常见问题。Ruby 的优雅语法和丰富的生态使其成为快速开发的利器，而稳定的开发环境是迈向成功的第一步。建议读者通过以下实践巩固知识：

  1. 尝试用 rails new my_app 创建第一个 Rails 项目。
  2. 探索 irb（交互式 Ruby 环境）进行实时代码测试。
  3. 参与开源项目或完成 LeetCode 题目，逐步提升 Ruby 技能。

如需进一步学习，可参考 Ruby 官方文档 或经典书籍《The Well-Grounded Rubyist》。保持好奇与实践，Ruby 将成为您开发旅程中的得力伙伴。

最新发布

查看更多文章