方法:使用 RubyInstaller(推荐)

RubyInstaller 是 Windows 上安装 Ruby 的官方工具,简单且可靠。它基于 MSYS2 提供了一个完整的 Ruby 环境。

1. 下载 RubyInstaller
  1. 访问官方网站:rubyinstaller.org
  2. 在“Downloads”页面,选择一个版本:
  • 推荐:选择带有 “WITH DEVKIT” 的版本(例如 Ruby+Devkit 3.2.2-1),因为 Devkit 包含编译工具,方便安装需要编译的 gem(如 Rails)。
  • 截至 2025 年 3 月 22 日,下载最新稳定版(可能是 3.x 系列)。
  1. 根据你的系统选择:
  • x64(64 位系统,大多数现代电脑适用)。
  • x86(32 位系统,较老的设备)。
2. 安装 Ruby
  1. 双击下载的 .exe 文件运行安装程序。
  2. 语言选择:默认是英语,直接点击 “OK”。
  3. 许可协议:勾选 “I accept the License”,点击 “Next”。
  4. 安装选项
  • 安装路径:默认是 C:\Ruby32-x64(版本号可能不同),可以保持不变。
  • 勾选 “Add Ruby executables to your PATH”:这会将 Ruby 添加到系统环境变量,方便命令行使用。
  • 勾选 “Associate .rb and .rbw files with this Ruby installation”(可选):让 .rb 文件默认用 Ruby 运行。
  1. 点击 “Install”,等待安装完成。
  2. MSYS2 安装(如果选了 Devkit 版本):
  • 安装完成后,会弹出命令行窗口,要求设置 MSYS2。
  • 按提示输入 1(安装 MSYS2 和基本开发工具链),然后按 Enter。
  • 完成后按任意键关闭窗口。
3. 验证安装
  1. 打开命令提示符(CMD):
  • Win + R,输入 cmd,回车。
  1. 检查 Ruby 版本:
   ruby -v

输出类似 ruby 3.2.2p53 (2023-03-30 revision e51014f9c0) [x64-mingw32] 表示成功。

  1. 检查 gem 版本:
   gem -v
4. 测试 Ruby 环境
  1. 在命令行输入:
   irb

进入交互式 Ruby 环境(IRB)。

  1. 输入:
   puts "Hello from Ruby!"

输出 Hello from Ruby! 表示环境正常。

  1. 退出 IRB:
   exit
5. 编写第一个程序(可选)
  1. 新建文件 hello.rb
  • 用记事本或任何文本编辑器,输入:
    ruby puts "Ruby is working on Windows!"
  • 保存为 hello.rb(确保后缀是 .rb,不是 .txt)。
  1. 运行:
   ruby hello.rb

输出:Ruby is working on Windows!


常见问题解决

  • “ruby is not recognized”
  • 安装时可能未勾选 “Add to PATH”。手动添加:
    1. 右键 “此电脑” -> “属性” -> “高级系统设置” -> “环境变量”。
    2. 在 “系统变量” 的 Path 中添加 Ruby 的 bin 目录(例如 C:\Ruby32-x64\bin)。
    3. 重启 CMD 再试。
  • gem 安装失败
  • 确保安装了 Devkit 版本。如果没有,重新下载带有 Devkit 的安装包。
  • 测试 Devkit:运行 ridk install,按提示选择默认选项。
  • 防火墙或权限问题
  • 以管理员身份运行 CMD(右键 CMD -> “以管理员身份运行”)。

可选:版本管理(高级用户)

Windows 上也可以用 rbenvRVM,但需要额外配置(如 WSL)。对于初学者,RubyInstaller 就足够了。如果需要多个版本,可以安装多个 RubyInstaller 到不同目录,然后手动切换 PATH。


下一步

  • 安装成功:告诉我你的 ruby -v 输出,我可以带你写代码或进一步配置!
  • 遇到问题:告诉我错误信息,我会帮你解决。
  • 扩展环境:想安装 Rails 或调试工具(如 Pry)吗?我可以继续指导。

准备好安装了吗?有什么具体需求吗?