下面给你一篇高质量、适合文章 / 技术文档 / 视频脚本使用的——

《5 分钟搭建 Windows Ruby 开发环境终极指南》

内容极简高效、完全实用，避免踩坑，一次成功。

⭐ 目标（5 分钟内完成）

你将完成：

• 安装 Ruby 最新稳定版
• 安装 MSYS2（用于构建原生扩展）
• 配置 gem、bundler 环境
• 安装 Rails / Jekyll / Sinatra 任选框架
• 完整运行一个“Hello Ruby”

本指南适配：
✔ Windows 10 / 11
✔ Ruby 2.7–3.3
✔ 适合新手与生产环境初始化

⏱ 第 1 分钟：下载 & 安装 RubyInstaller

Windows 下最佳 Ruby 安装方式就是 RubyInstaller（内含 DevKit）。

👉 打开
https://rubyinstaller.org/downloads/

选择：

✔ 推荐版本（2025）

• Ruby+Devkit 3.2.X (x64)
  或者
• Ruby+Devkit 3.3.X Preview (x64)

✔ 如果需要兼容旧项目

• Ruby+Devkit 2.7.X

安装时保持默认即可（尤其注意“Add Ruby executables to your PATH”要勾选）。

⏱ 第 2 分钟：运行 MSYS2 自动配置（DevKit）

安装好 RubyInstaller 后，会自动打开一个终端，提示你安装 MSYS2。

请选择：

1 - MSYS2 base installation

等待它自动安装完成即可（1 分钟左右）。

MSYS2 主要用于：

• 生成 C 扩展（如 Nokogiri）
• 构建原生依赖
• 让 gem 安装更顺畅

⏱ 第 3 分钟：验证 Ruby & 安装 Bundler

打开 PowerShell 或 CMD：

ruby -v
gem -v

如果正常输出版本号 → 成功！

安装 Bundler：

gem install bundler

加速 gem 下载（推荐使用 CDN）：

gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/

⏱ 第 4 分钟：安装常用开发框架（任选）

✔ 安装 Rails

gem install rails

验证：

rails -v

✔ 安装 Jekyll（适合博客）

gem install jekyll bundler

✔ 安装 Sinatra（最轻量 Web 框架）

gem install sinatra

⏱ 第 5 分钟：运行你的第一个 Ruby 程序

创建文件：

hello.rb

puts "Hello, Ruby!"

运行：

ruby hello.rb

看到输出：

Hello, Ruby!

🎉 你的 Windows Ruby 开发环境已完全搭建完成！

🚀 进阶：3 个关键优化（让 Ruby 在 Windows 上更快、更稳）

1. 开启 Ridk（开发工具链）

在终端运行：

ridk install

选择：

2 - MSYS2 and MINGW development toolchain

这样可以确保 gem 扩展全部可编译。

2. 为 Rails 安装 Node.js + Yarn

Rails 需要 JS Runtime：

安装 Node.js

安装 yarn

npm install -g yarn

确认：

yarn -v

3. 安装 RubyMine 或 VSCode Ruby 插件

VSCode 推荐插件：

• Ruby （语言支持）
• Solargraph（智能补全）
• Ruby LSP（官方 Ruby 语言服务器）
• VSCode Ruby（语法高亮）

📦 附赠：Ruby 开发环境快速测试脚本

新建 test.rb：

require "json"

puts "Ruby Version: #{RUBY_VERSION}"
puts "JSON: #{JSON.dump({ok: true})}"

运行：

ruby test.rb

看到 JSON 输出证明环境完全正常。

⭐ 总结（真正 5 分钟）