Ruby 安装 – Windows

在 Windows 上安装 Ruby 中文讲解

在 Windows 系统上安装 Ruby 是开始使用 Ruby 编程语言的第一步。以下是详细的安装指南，涵盖安装方法、配置、验证步骤、常见问题及注意事项，适合初学者和有经验的开发者。截至 2025 年 8 月，Ruby 的最新稳定版本为 3.4.x。

---

1. 通过 RubyInstaller 安装 Ruby（推荐）

RubyInstaller 是 Windows 上安装 Ruby 的最简单和推荐方式，提供预编译的 Ruby 环境和 DevKit（用于编译 C 扩展的工具）。

1. 下载 RubyInstaller：

• 访问 RubyInstaller 官网（rubyinstaller.org）。
• 选择最新版本，如 Ruby+DevKit 3.4.x (x64)（推荐 64 位版本）。
• 如果需要 32 位版本，选择 x86 版本。

1. 运行安装程序：

• 双击下载的 .exe 文件（如 rubyinstaller-devkit-3.4.0-1-x64.exe）。
• 接受许可协议，选择安装路径（默认推荐 C:\Ruby34-x64）。
• 重要：勾选以下选项：
  • “Add Ruby executables to your PATH”：将 Ruby 添加到系统环境变量。
  • “Associate .rb and .rbw files with this Ruby installation”：将 .rb 文件关联到 Ruby。
• 继续安装，完成 DevKit 的设置（按提示运行 ridk install，选择默认选项）。

1. 验证安装：

• 打开命令提示符（CMD）或 PowerShell： bash ruby -v
  • 应输出类似：ruby 3.4.0 (2025-XX-XX) [x64-mingw32]。
    bash gem -v
  • 确认 RubyGems 版本，如 3.5.x。
• 验证 DevKit：
  bash ridk version

1. 安装完成：

• RubyInstaller 默认包含 RubyGems（Ruby 的包管理器）和 DevKit（用于编译原生扩展）。

---

2. 使用版本管理器安装 Ruby（高级选项）

版本管理器允许在 Windows 上管理多个 Ruby 版本，适合需要不同版本的开发者。推荐工具是 pik 或 rbenv（通过 WSL）。

方法 1：使用 pik

pik 是一个轻量级的 Windows Ruby 版本管理器。

1. 安装 pik：

• 下载 pik（GitHub 仓库）。
• 运行安装程序或解压到指定目录。
• 将 pik 添加到 PATH：
  bash set PATH=%PATH%;C:\path\to\pik

1. 安装 Ruby 版本：

   pik install ruby 3.4.0
   pik use ruby-3.4.0-x64

3. 验证：

   ruby -v

方法 2：使用 WSL（Windows Subsystem for Linux）

WSL 提供 Linux 环境，适合需要 rbenv 或 asdf 的开发者。

1. 启用 WSL：

• 在 PowerShell 中运行：
  bash wsl --install
• 默认安装 Ubuntu，完成后重启系统。

1. 在 WSL 中安装 Ruby（以 Ubuntu 为例）：

• 更新包：
  bash sudo apt update
• 安装 rbenv：
  bash sudo apt install git curl libssl-dev libreadline-dev zlib1g-dev build-essential git clone https://github.com/rbenv/rbenv.git ~/.rbenv echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc echo 'eval "$(rbenv init -)"' >> ~/.bashrc source ~/.bashrc git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
• 安装 Ruby：
  bash rbenv install 3.4.0 rbenv global 3.4.0
• 验证：
  bash ruby -v

1. 从 Windows 访问：

• WSL 的 Ruby 可通过 wsl ruby 命令在 Windows CMD/PowerShell 中调用。

推荐：初学者直接使用 RubyInstaller，高级用户可尝试 WSL + rbenv。

---

3. 配置与常用工具

1. RubyGems 配置：

• 检查 RubyGems：
  bash gem -v
• 更新 RubyGems：
  bash gem update --system
• 加速 Gem 安装（使用国内镜像，如 Ruby China）：
  bash gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/ gem sources -l

1. 安装 Bundler：

• 用于管理项目依赖：
  bash gem install bundler

1. 开发工具：

• VS Code：安装 Ruby LSP 插件，增强代码补全和调试。
• RubyMine：JetBrains 提供的专业 Ruby IDE（付费）。
• 命令行：CMD、PowerShell 或 Windows Terminal 均可。

1. 调试工具：

• 安装 pry（交互式调试工具）：
  bash gem install pry

---

4. 测试环境

1. 创建测试文件：

• 新建文件 test.rb：
  puts “Hello, Ruby on Windows!”
• 保存到任意目录（如 C:\Users\YourName\test.rb）。

1. 运行测试：

   ruby test.rb

• 应输出：Hello, Ruby on Windows!

1. 测试 Rails（可选）：

• 安装 Rails：
  bash gem install rails
• 创建新 Rails 项目：
  bash rails new myapp cd myapp rails server
• 访问 http://localhost:3000 检查是否运行。

---

5. 常见问题与解决

1. PATH 配置问题：

• 如果 ruby -v 无效，检查环境变量：
  • 打开“系统属性” > “环境变量” > “Path”，确保包含 Ruby 安装路径（如 C:\Ruby34-x64\bin）。
• 手动添加：
  bash setx PATH "%PATH%;C:\Ruby34-x64\bin"

1. Gem 安装失败：

• 确保 DevKit 已安装（ridk install）。
• 检查网络连接，或使用国内镜像（如 Ruby China）。
• 如果报错 missing C extensions，运行：
  bash ridk install

1. 权限问题：

• 避免在系统目录（如 C:\Program Files）运行 gem install，改用用户目录。
• 以管理员身份运行 CMD/PowerShell：
  bash gem install <gem_name>

1. 编码问题：

• Windows CMD 默认非 UTF-8，可能导致中文乱码。切换到 PowerShell 或设置 CMD 编码：
  bash chcp 65001

---

6. 进阶建议

• 安装 Rails：快速搭建 Web 应用：

  gem install rails
  rails -v

• 使用 Docker：
• 避免 Windows 环境问题，使用 Docker：
  bash docker run -it ruby:3.4 cmd
• 开发环境优化：
• 使用 Windows Terminal 替换 CMD，提升体验。
• 安装 Git for Windows（git-scm.com)，便于版本控制。
• 社区资源：
• Ruby 官方文档（ruby-doc.org）
• Ruby China（ruby-china.org）
• Stack Overflow 或 Reddit 的 r/ruby。

---

7. 注意事项

• 版本选择：RubyInstaller 的 3.4.x 是最新稳定版，适合新项目。旧项目可能需要 2.7.x。
• 安全更新：定期运行 gem update 获取安全修复。
• 数据库依赖：若使用 Rails，可能需安装 SQLite、PostgreSQL 或 MySQL：

  gem install sqlite3

通过以上步骤，你可以在 Windows 上成功搭建 Ruby 环境。如果需要针对特定工具（如 Rails、VS Code 配置）或问题的深入讲解，请告诉我！