Windows 11 Ruby 开发环境配置

[hex]

Windows 11 如何配置 Ruby 开发环境。

简单来说就是还是需要 WSL 环境来开发 Ruby。

[hex]

好的，没问题！在 Windows 11 上配置 Ruby 开发环境主要有两种主流方法，我会为你详细介绍这两种方法，并给出我的建议。

方法概览

1. 方法一：使用 RubyInstaller (原生 Windows 方式)

   • 简介：这是最直接、最简单的方法，直接在 Windows 系统上安装 Ruby 解释器和相关工具。
   • 优点：安装简单快捷，对 Windows 系统集成度高，适合初学者或运行简单脚本。
   • 缺点：部分依赖 C 语言编译的 Gem（Ruby 的包）在 Windows 上可能会遇到兼容性或编译问题。

2. 方法二：使用 WSL 2 (Windows Subsystem for Linux)

   • 简介：在 Windows 11 中启用一个完整的 Linux 子系统（如 Ubuntu），然后在 Linux 环境中安装和配置 Ruby。
   • 优点：强烈推荐此方法，尤其是对于 Web 开发（如 Ruby on Rails）。它能提供与生产服务器（通常是 Linux）一致的环境，几乎不存在 Gem 兼容性问题，性能也更好。
   • 缺点：需要额外学习一些基本的 Linux 命令，初次设置步骤稍多。

---

方法一：使用 RubyInstaller (原生 Windows 方式)

步骤 1：下载 RubyInstaller

1. 访问 RubyInstaller 官方网站：https://rubyinstaller.org/downloads/
2. 在下载页面，你会看到几个版本。选择 WITH DEVKIT 的版本。DevKit 是一个工具包，用于编译那些包含 C/C++ 源码的 Gem，非常重要。通常选择标记为 “RECOMMENDED” 的最新稳定版即可（例如 Ruby+Devkit 3.2.2-1 (x64)）。

步骤 2：安装 Ruby

1. 双击下载的 .exe 文件开始安装。

2. 接受许可协议。

3. 选择安装路径和选项：

   • 勾选 Add Ruby executables to your PATH：这一步至关重要！ 必须勾选，否则你无法在命令行中直接使用 ruby 命令。
   • 勾选 Associate .rb and .rbw files with this Ruby installation：方便你双击运行 Ruby 脚本。
   • 保持默认安装路径即可（如 C:\Ruby32-x64）。

4. 选择组件：保持默认勾选的 “MSYS2 development toolchain” 即可。

5. 点击 “Install” 开始安装。

步骤 3：安装 MSYS2 工具链

1. Ruby 主程序安装完成后，会弹出一个命令行窗口，提示进行 “RIDK INSTALL”。

2. 这个步骤是用来安装和配置 DevKit（即 MSYS2 工具链）的。

3. 直接按 ENTER 键，选择默认的 1 - MSYS2 base installation。

4. 程序会自动下载、解压并安装所需的工具。这个过程可能需要几分钟，请耐心等待。

5. 安装完成后，再次按 ENTER 键退出该窗口。

步骤 4：验证安装

1. 打开一个新的命令提示符（CMD）或 PowerShell 窗口（注意： 如果之前有打开的，请关掉后重新打开，以加载新的环境变量）。

2. 输入以下命令来验证 Ruby、Gem 和 DevKit 是否安装成功：

   # 检查 Ruby 版本
   ruby -v
   # 应该输出类似：ruby 3.2.2p53 (2023-03-30 revision e51014f9c0) [x64-mingw-ucrt]
   
   # 检查 Gem 版本 (Gem 是 Ruby 的包管理器)
   gem -v
   # 应该输出类似：3.4.10
   
   # 检查 DevKit (RIDK) 是否安装正确
   ridk version
   # 应该会输出 MSYS2 和 GCC 等工具的版本信息
   

如果以上命令都能正确输出版本信息，恭喜你，你的原生 Ruby 环境已经配置好了！

---

方法二：使用 WSL 2 (强烈推荐)

WSL 2 让你在 Windows 中无缝运行一个真实的 Linux 内核，这是现代 Web 开发的最佳实践。

步骤 1：安装 WSL 2 和 Linux 发行版

1. 以 管理员身份 打开 PowerShell 或 Windows 终端。

2. 运行以下命令来安装 WSL 和默认的 Ubuntu 发行版：

   wsl --install
   

3. 这个命令会自动启用所需功能、下载最新的 Linux 内核、并安装 Ubuntu。

4. 安装完成后，根据提示 重启你的电脑。

步骤 2：初始化你的 Linux 环境

1. 重启后，Ubuntu 会自动开始初始化。你需要设置一个 用户名 和 密码。这个用户名和密码是专用于你的 Linux 子系统的，与你的 Windows 账户无关。

2. 进入 Ubuntu 终端后，首先更新软件包列表：

   sudo apt update
   sudo apt upgrade -y
   

步骤 3：在 WSL (Ubuntu) 中安装 Ruby

在 Linux 中，我们通常不直接用 apt 安装 Ruby（版本太旧），而是使用版本管理器，如 rbenv 或 rvm。这里以 rbenv 为例，因为它更轻量、无侵入性。

1. 安装 rbenv 的依赖包：

   sudo apt install -y git curl libssl-dev libreadline-dev zlib1g-dev autoconf bison build-essential libyaml-dev libreadline-dev libncurses5-dev libffi-dev libgdbm-dev
   

2. 安装 rbenv 和 ruby-build：

   # 安装 rbenv
   git clone https://github.com/rbenv/rbenv.git ~/.rbenv
   
   # 配置环境变量，让 shell 能找到 rbenv 命令
   echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
   echo 'eval "$(rbenv init -)"' >> ~/.bashrc
   source ~/.bashrc
   
   # 安装 ruby-build 插件（用于 rbenv install 命令）
   git clone https://github.com/rbenv/ruby-build.git "$(rbenv root)"/plugins/ruby-build
   

   注意： 运行 source ~/.bashrc 或重启终端后，新配置才会生效。

3. 使用 rbenv 安装 Ruby：

   # 查看所有可安装的 Ruby 版本
   rbenv install -l
   
   # 安装一个具体的 Ruby 版本（例如 3.2.2，建议安装最新的稳定版）
   rbenv install 3.2.2
   
   # 设置全局默认的 Ruby 版本
   rbenv global 3.2.2
   

   安装过程会从源码编译 Ruby，可能需要 5-15 分钟。

步骤 4：验证安装

在 WSL 的 Ubuntu 终端中输入：

# 检查 Ruby 版本
ruby -v
# 应该输出：ruby 3.2.2p53...

# 检查 Gem 版本
gem -v

# 检查 rbenv 是否正常工作
which ruby
# 应该输出类似：/home/你的用户名/.rbenv/shims/ruby

至此，你在 WSL 中的 Ruby 环境就完美配置好了。

---

开发工具推荐：VS Code

无论你选择哪种方法，都强烈推荐使用 Visual Studio Code 作为你的代码编辑器。

• 对于方法一 (RubyInstaller)：直接在 Windows 上安装 VS Code，并安装 “Ruby” 和 “Ruby Solargraph” 扩展即可。
• 对于方法二 (WSL)：这是 VS Code 的强大之处！
  1. 在 Windows 上安装 VS Code。
  2. 在 VS Code 的扩展市场中，安装 “WSL” 扩展。
  3. 安装后，你可以在 WSL 终端的项目文件夹中，输入 code . 命令。
  4. VS Code 会在 Windows 侧启动，但它会通过远程连接到你的 WSL 环境。这意味着你的代码、终端、调试器、Git 等所有工具都运行在 Linux 环境中，享受其所有优点，而你仍然使用 Windows 流畅的图形界面。

---

总结与建议

特性	RubyInstaller (原生 Windows)	WSL 2 (Linux 子系统)
安装难度	(非常简单)	(稍复杂，需命令行)
兼容性	(部分 Gem 可能失败)	(与服务器环境一致，兼容性极佳)
性能	(不错)	(文件 I/O 性能更好，更接近原生 Linux)
生态工具	(大部分可用)	(所有 Linux 工具链都可用)
推荐人群	Ruby 初学者、运行简单脚本、不想接触 Linux 的用户	所有 Web 开发者 (尤其是 Rails)、追求最佳兼容性和性能的用户

我的最终建议是：

• 如果你只是想快速学习 Ruby 语法或运行一些简单的脚本，RubyInstaller 完全够用。
• 如果你打算进行任何严肃的 Web 开发（特别是使用 Ruby on Rails 框架），请 毫不犹豫地选择 WSL 2。它能为你省去未来无数的兼容性头疼问题，是目前 Windows 平台上进行 Ruby 开发的黄金标准。

[kacha1]

Codespaces 这个免费用户额度使用完了还会重置吗?还是需要付费了？

如果需要付费的话，打算创建本地环境了

[hex]

是的，

貌似得付费。