Ruby 安装 – Linux

在 Linux 上安装 Ruby 中文讲解

在 Linux 系统上安装 Ruby 是开始使用 Ruby 编程语言的第一步。以下是针对 Linux（以 Ubuntu/Debian 和 CentOS 为例）的详细安装指南，涵盖多种方法、验证步骤、常见问题及注意事项，帮助你快速搭建 Ruby 环境。截至 2025 年 8 月，Ruby 的最新稳定版本为 3.4.x。

---

1. 通过包管理器安装 Ruby

Linux 发行版通常提供包管理器来安装 Ruby，适合快速入门。

Ubuntu/Debian

1. 更新包列表：

   sudo apt update

2. 安装 Ruby：

• 安装完整 Ruby 环境（包括 RubyGems 和开发工具）：
  bash sudo apt install ruby-full
• 这通常安装最新稳定版本（如 Ruby 3.4.0）。

2. 验证安装：

   ruby -v

• 应输出类似：ruby 3.4.0 (2025-XX-XX) [x86_64-linux].

   gem -v

• 确认 RubyGems 版本，如 3.5.x。

1. 安装开发依赖（用于编译 Gem）：

   sudo apt install build-essential libssl-dev zlib1g-dev

CentOS/RHEL

1. 启用 EPEL 仓库（若未启用）：

   sudo yum install epel-release

2. 安装 Ruby：

   sudo yum install ruby ruby-devel

3. 验证安装：

   ruby -v
   gem -v

4. 安装开发工具：

   sudo yum groupinstall "Development Tools"
   sudo yum install openssl-devel zlib-devel

注意：包管理器安装的 Ruby 版本可能不是最新，适合初学者或稳定需求。若需最新版本，考虑其他方法。

---

2. 使用版本管理器安装 Ruby（推荐）

版本管理器（如 rbenv、asdf 或 RVM）允许安装多个 Ruby 版本并灵活切换，适合开发不同项目。

方法 1：使用 rbenv

rbenv 轻量易用，推荐给初学者。

1. 安装依赖：

• Ubuntu/Debian：
  bash sudo apt install git curl libssl-dev libreadline-dev zlib1g-dev build-essential
• CentOS/RHEL：
  bash sudo yum install git curl openssl-devel readline-devel zlib-devel gcc make

1. 安装 rbenv：

   git clone https://github.com/rbenv/rbenv.git ~/.rbenv

3. 配置环境变量：

• 编辑 ~/.bashrc 或 ~/.zshrc：
  bash echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc echo 'eval "$(rbenv init -)"' >> ~/.bashrc source ~/.bashrc

3. 安装 ruby-build 插件（用于编译 Ruby）：

   git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build

5. 安装 Ruby：

   rbenv install 3.4.0
   rbenv global 3.4.0

6. 验证：

   ruby -v

方法 2：使用 asdf

asdf 支持多种语言，适合需要管理其他工具（如 Node.js）的开发者。

1. 安装依赖（同 rbenv）。
2. 安装 asdf：

   git clone https://github.com/asdf-vm/asdf.git ~/.asdf
   echo '. $HOME/.asdf/asdf.sh' >> ~/.bashrc
   echo '. $HOME/.asdf/completions/asdf.bash' >> ~/.bashrc
   source ~/.bashrc

3. 添加 Ruby 插件：

   asdf plugin add ruby

4. 安装 Ruby：

   asdf install ruby 3.4.0
   asdf global ruby 3.4.0

5. 验证：

   ruby -v

方法 3：使用 RVM

RVM 功能丰富，适合高级用户。

1. 安装 RVM：

   curl -sSL https://get.rvm.io | bash -s stable
   source ~/.rvm/scripts/rvm

2. 安装依赖：

   rvm requirements

3. 安装 Ruby：

   rvm install 3.4.0
   rvm use 3.4.0 --default

4. 验证：

   ruby -v

推荐：rbenv 简单直观，适合初学者；asdf 适合多语言开发者；RVM 适合需要复杂配置的高级用户。

---

3. 从源码编译安装 Ruby

适合需要最新版本或自定义配置的场景。

1. 安装依赖：

• Ubuntu/Debian：
  bash sudo apt install autoconf bison build-essential libssl-dev libyaml-dev libreadline-dev zlib1g-dev
• CentOS/RHEL：
  bash sudo yum install gcc make openssl-devel libyaml-devel readline-devel zlib-devel

1. 下载源码：

• 从 ruby-lang.org 下载最新版本（如 ruby-3.4.0.tar.gz）：
  bash wget https://cache.ruby-lang.org/pub/ruby/3.4/ruby-3.4.0.tar.gz tar -xvzf ruby-3.4.0.tar.gz cd ruby-3.4.0

1. 编译与安装：

   ./configure
   make
   sudo make install

4. 验证：

   ruby -v

---

4. 验证与测试环境

1. 检查 Ruby 和 Gem：

   ruby -v
   gem -v

2. 测试代码：

• 创建文件 test.rb：
  ruby puts "Hello, Ruby on Linux!"
• 运行：

   ruby test.rb

• 应输出：Hello, Ruby on Linux!

1. 安装常用 Gem：

   gem install bundler
   gem install rails

---

5. 配置 RubyGems（可选）

• 加速 Gem 安装：
• 默认 RubyGems 使用 rubygems.org，可能较慢。切换到国内镜像（如 Ruby China）：
  bash gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/ gem sources -l
• 更新 RubyGems：

   gem update --system

---

6. 常见问题与解决

• 依赖缺失：
• 错误如 cannot load such file 或 make failed，通常缺少开发库。安装 build-essential 或对应依赖。
• 版本冲突：
• 使用 rbenv/asdf 隔离项目环境：
  bash rbenv local 3.3.0 # 为当前项目设置 Ruby 版本
• 权限问题：
• 避免用 sudo gem install，使用版本管理器以用户权限安装。
• PATH 配置错误：
• 确保 Ruby 可执行文件在 PATH 中：
  bash export PATH="$HOME/.rbenv/bin:$PATH" # 或对应路径

---

7. 进阶建议

• 安装 Rails：

  gem install rails
  rails -v

• 使用 Docker：
• 避免依赖问题，使用官方 Ruby 镜像：
  bash docker run -it ruby:3.4 bash
• 开发工具：
• 安装 VS Code（搭配 Ruby LSP 插件）或 RubyMine。
• 调试工具：gem install pry。
• 社区资源：
• Ruby China（ruby-china.org）
• 官方文档（ruby-doc.org）
• GitHub 的 rbenv/ruby-build 项目。

---

8. 注意事项

• 选择版本：生产环境推荐最新稳定版（3.4.x），旧项目可能需要特定版本（如 2.7.x）。
• 安全更新：定期运行 gem update 获取安全修复。
• 数据库依赖：若使用 Rails，可能需安装 PostgreSQL/MySQL：

  sudo apt install postgresql libpq-dev  # Ubuntu

通过以上步骤，你可以在 Linux 上成功安装和配置 Ruby 环境。如果需要针对特定发行版、版本管理器或 Rails 环境的深入指导，请告诉我！