在 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 和开发工具）： 
      sudo apt install ruby-full
    • 这通常安装最新稳定版本（如 Ruby 3.4.0）。
  3. 验证安装： 
    ruby -v
    • 应输出类似：ruby 3.4.0 (2025-XX-XX) [x86_64-linux].
    gem -v
    • 确认 RubyGems 版本，如 3.5.x。
  4. 安装开发依赖（用于编译 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： 
      sudo apt install git curl libssl-dev libreadline-dev zlib1g-dev build-essential
    • CentOS/RHEL： 
      sudo yum install git curl openssl-devel readline-devel zlib-devel gcc make
  2. 安装 rbenv： 
    git clone https://github.com/rbenv/rbenv.git ~/.rbenv
  3. 配置环境变量：
    • 编辑 ~/.bashrc 或 ~/.zshrc： 
      echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc
source ~/.bashrc
  4. 安装 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： 
      sudo apt install autoconf bison build-essential libssl-dev libyaml-dev libreadline-dev zlib1g-dev
    • CentOS/RHEL： 
      sudo yum install gcc make openssl-devel libyaml-devel readline-devel zlib-devel
  2. 下载源码：
    • 从 ruby-lang.org 下载最新版本（如 ruby-3.4.0.tar.gz）： 
      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
  3. 编译与安装： 
    ./configure
make
sudo make install
  4. 验证： 
    ruby -v
4. 验证与测试环境
  1. 检查 Ruby 和 Gem： 
    ruby -v
gem -v
  2. 测试代码：
    • 创建文件 test.rb： 
      puts "Hello, Ruby on Linux!"
    • 运行：
    ruby test.rb
    • 应输出：Hello, Ruby on Linux!
  3. 安装常用 Gem： 
    gem install bundler
gem install rails
5. 配置 RubyGems（可选）
  • 加速 Gem 安装：
    • 默认 RubyGems 使用 rubygems.org，可能较慢。切换到国内镜像（如 Ruby China）： 
      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 隔离项目环境： 
      rbenv local 3.3.0  # 为当前项目设置 Ruby 版本
  • 权限问题：
    • 避免用 sudo gem install，使用版本管理器以用户权限安装。
  • PATH 配置错误：
    • 确保 Ruby 可执行文件在 PATH 中： 
      export PATH="$HOME/.rbenv/bin:$PATH"  # 或对应路径
7. 进阶建议
  • 安装 Rails： 
    gem install rails
rails -v
  • 使用 Docker：
    • 避免依赖问题，使用官方 Ruby 镜像： 
      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 环境的深入指导，请告诉我！

# ruby # linux # 开发语言
Logo
葡萄城开发者空间

葡萄城是专业的软件开发技术和低代码平台提供商，聚焦软件开发技术，以“赋能开发者”为使命，致力于通过表格控件、低代码和BI等各类软件开发工具和服务

更多推荐

提示工程架构师进阶：AI创新Prompt的量化分析

本文将系统讲解“AI创新Prompt的量化分析”——从理论框架到实战工具，帮助你从“经验驱动”的提示设计者，进阶为“数据驱动”的提示工程架构师。量化分析的理论基础：为什么提示效果需要量化？核心原则与思维转变；量化分析框架构建：从目标定义、实验设计到指标体系的全流程方法论；实战案例：文本分类任务的Prompt量化优化：手把手带你设计实验、采集数据、计算指标、得出结论；进阶指标与多维度评估：超越“准确

avatar 葡萄城开发者空间
cover

如何在鸿蒙中实现大数据处理与分析？

avatar 葡萄城开发者空间
cover

GitHub 上 Star 数量前 18 的开源 AI Agent 项目

avatar 葡萄城开发者空间