Linux安装Ruby及环境配置方法

本文深入解析了在Linux各主流发行版（Ubuntu/Debian、CentOS/RHEL及衍生系统）中安装和配置Ruby环境的常见陷阱与实战方案：从官方包管理器因稳定策略导致Ruby版本严重滞后，到仓库元数据下载失败、gem权限错误、rails new卡在sqlite3编译等高频问题，逐一给出安全、可靠、符合最佳实践的解决路径——推荐使用rbenv或asdf进行用户级Ruby版本管理，强调避免sudo gem、正确安装开发依赖（如libsqlite3-dev、openssl-devel等），并提醒开发者注意Ruby ABI变更带来的gem重装必要性；无论你是刚接触Rails的新手还是部署生产环境的运维工程师，这篇干货满满的指南都能帮你避开90%的配置坑，快速获得可信赖的现代Ruby开发环境。

Ubuntu/Debian 上用 apt 装 Ruby 为什么总不是最新版？

因为官方源默认绑定了系统稳定策略，apt install ruby 拿到的通常是旧 LTS 版本（比如 3.0.x），连 ruby -v 都可能显示 3.0.2 —— 这对 Rails 7.1+ 或新 gem 来说，轻则报 unknown keyword: **，重则直接 LoadError。

实操建议：

• 别硬改 /etc/apt/sources.list 加第三方源，容易和系统包管理冲突
• 用 rbenv 或 ruby-build 管理版本更安全：先 curl -fsSL https://github.com/rbenv/rbenv-installer/raw/HEAD/bin/rbenv-installer | bash，再把 ~/.rbenv/bin 加进 $PATH
• 装完运行 rbenv install 3.2.2（选你需要的版本），再 rbenv global 3.2.2
• 验证：开新终端，执行 which ruby 应该返回 ~/.rbenv/shims/ruby，不是 /usr/bin/ruby

CentOS/RHEL 8+ 安装 Ruby 时提示 Failed to download metadata for repo 'appstream'

这是系统默认启用了 CDN 镜像但网络不通，或仓库已 EOL（比如 CentOS 8 在 2021 年底就停止维护）。直接 yum install ruby 会卡住或报错。

实操建议：

• 先确认系统状态：cat /etc/redhat-release，如果是 CentOS 8 或 Stream 8，优先考虑迁移到 Rocky/AlmaLinux
• 临时解决：运行 sudo dnf --disablerepo=appstream --enablerepo=baseos install ruby，但仅限应急
• 长期方案：用 asdf（比 rbenv 更轻量）：git clone https://github.com/asdf-vm/asdf.git ~/.asdf --branch v0.14.0，然后 asdf plugin-add ruby，再 asdf install ruby 3.2.2
• 注意：RHEL/CentOS 的 openssl-devel、zlib-devel、gcc 必须提前装好，否则 asdf install 编译失败

gem install bundler 失败，报 Permission denied @ dir_s_mkdir

说明你正在用系统 Ruby（比如 /usr/bin/ruby）跑 gem，而系统目录不允许普通用户写入。这不是权限问题，是路径设计问题。

实操建议：

• 别加 sudo gem install —— 会污染系统 gemset，后续 bundle exec 行为不可控
• 确保已用 rbenv 或 asdf 切换到用户级 Ruby：检查 ruby -e "puts Gem.dir" 输出是否在 ~/.rbenv/ 或 ~/.asdf/ 下
• 如果仍报错，执行 gem environment 查看 GEM PATHS: 第一行是否可写；若不可写，删掉 ~/.gem 并重新初始化环境
• 装 Bundler 推荐用 gem install bundler -v '~> 2.4'（避免 2.5+ 对 Ruby 3.1 以下兼容问题）

Ruby 环境配好了，但 rails new 卡在 Installing sqlite3

SQLite3 是 C 扩展，依赖本地编译工具链和 sqlite3.h 头文件。很多 Linux 发行版默认不装开发头包，导致 gem install sqlite3 编译失败，进而阻塞 rails new。

实操建议：

• Ubuntu/Debian：装 sudo apt install libsqlite3-dev build-essential
• CentOS/RHEL/Rocky：装 sudo dnf install sqlite-devel gcc make
• 如果用的是 ARM64 机器（如 M1 Mac 的 Linux VM 或树莓派），还要额外装 libsqlite3-dev 对应架构的交叉编译支持
• 不想用 SQLite？新建项目时加 --database=postgresql，但得先确保 pg_config 在 $PATH 中

最常被忽略的一点：每次换 Ruby 版本后，所有 gem 都得重装，包括 bundler 和 rails —— 不是缓存问题，是二进制扩展绑定到了具体 Ruby ABI。别试图复用旧 gem 目录。

终于介绍完啦！小伙伴们，这篇关于《Linux安装Ruby及环境配置方法》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！