在 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 版本。

  2. 运行安装程序：

    • 双击下载的 .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，选择默认选项）。

  3. 验证安装：

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

  4. 安装完成：

    • RubyInstaller 默认包含 RubyGems（Ruby 的包管理器）和 DevKit（用于编译原生扩展）。
2. 使用版本管理器安装 Ruby（高级选项）

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

方法 1：使用 pik

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

  1. 安装 pik：
    • 下载 pik（GitHub 仓库）。
    • 运行安装程序或解压到指定目录。
    • 将 pik 添加到 PATH： 
      set PATH=%PATH%;C:\path\to\pik
  2. 安装 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 中运行： 
      wsl --install
    • 默认安装 Ubuntu，完成后重启系统。
  2. 在 WSL 中安装 Ruby（以 Ubuntu 为例）：
    • 更新包： 
      sudo apt update
    • 安装 rbenv： 
      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： 
      rbenv install 3.4.0
rbenv global 3.4.0
    • 验证： 
      ruby -v
  3. 从 Windows 访问：
    • WSL 的 Ruby 可通过 wsl ruby 命令在 Windows CMD/PowerShell 中调用。

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

3. 配置与常用工具

  1. RubyGems 配置：

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

  2. 安装 Bundler：

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

  3. 开发工具：

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

  4. 调试工具：

    • 安装 pry（交互式调试工具）： 
      gem install pry
4. 测试环境

  1. 创建测试文件：

    • 新建文件 test.rb：

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

  2. 运行测试：

    ruby test.rb
    • 应输出：Hello, Ruby on Windows!

  3. 测试 Rails（可选）：

    • 安装 Rails： 
      gem install rails
    • 创建新 Rails 项目： 
      rails new myapp
cd myapp
rails server
    • 访问 http://localhost:3000 检查是否运行。
5. 常见问题与解决

  1. PATH 配置问题：

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

  2. Gem 安装失败：

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

  3. 权限问题：

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

  4. 编码问题：

    • Windows CMD 默认非 UTF-8，可能导致中文乱码。切换到 PowerShell 或设置 CMD 编码： 
      chcp 65001
6. 进阶建议
  • 安装 Rails：快速搭建 Web 应用： 
    gem install rails
rails -v
  • 使用 Docker：
    • 避免 Windows 环境问题，使用 Docker： 
      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 配置）或问题的深入讲解，请告诉我！

# ruby # windows # 开发语言
Logo
鲲鹏昇腾开发者社区

鲲鹏昇腾开发者社区是面向全社会开放的“联接全球计算开发者，聚合华为+生态”的社区，内容涵盖鲲鹏、昇腾资源，帮助开发者快速获取所需的知识、经验、软件、工具、算力，支撑开发者易学、好用、成功，成为核心开发者。

更多推荐

cover

ModelEngine是华为推出的一个‌全流程AI开发工具链‌打造数学解题小助手

avatar 鲲鹏昇腾开发者社区

深度解析昇腾Catlass：C++模板元编程与高性能算子开发范式(1)

/ 1. 定义基本的形状配置// 一个AI Core处理的大小// 一个Warp处理的大小// 基础指令处理的大小// 2. 定义流水线策略 (Pipeline Strategy)// Stage=2 意味着开启 Double Buffering (双缓冲)，这是高性能的关键！对齐是生命线：Catlass 极其依赖向量化指令。你的输入矩阵维度（M, N, K）如果不能被16或32整除，模板实例化可

avatar 鲲鹏昇腾开发者社区
cover

2025年最强AI论文生成器：7款神器实测，鲲鹏智写一键搞定毕业！

avatar 鲲鹏昇腾开发者社区