Linux下搭建RubyonRails环境教程

本文深入剖析了在Linux系统上搭建Ruby on Rails开发环境的常见陷阱与最佳实践，明确指出直接使用系统包管理器安装Ruby和Rails极易因版本过旧、ABI不兼容、权限混乱及缺失编译依赖而导致`rails new`失败、`bin/dev`启动报错或`bundler/setup`加载异常；文章强烈推荐采用`rbenv + ruby-build`方案安全安装Ruby 3.2.2（当前与Rails 7.1+兼容性最稳定），并强调Node.js ≥18.0.0与Yarn v1为Rails 7硬性依赖，同时给出从系统依赖安装、rbenv配置、Ruby版本验证到JS工具链初始化的完整、可复现操作链，助开发者一步避开90%的环境配置坑。

直接用系统包管理器装 Ruby 和 Rails 会出什么问题

Ubuntu/Debian 的 sudo apt install ruby-full 默认装的是 3.0.x 或更老版本，Rails 7.1+ 要求 Ruby ≥ 3.1.0；CentOS/RHEL 的仓库 Ruby 更旧，甚至不带 gem 的完整功能。装完跑 rails new 很可能报错：incompatible library version 或 cannot load such file -- bundler/setup。

这不是配置问题，是底层 ABI 不匹配。系统包为稳定性牺牲更新节奏，不适合 Rails 开发——尤其你打算用 Hotwire、Import Maps 或 jsbundling-rails 这类新特性时。

• Ruby 版本太低 → rails new 失败或生成项目后 bin/dev 启动报错
• 系统级 gem 权限混乱 → 安装 bundler 或 rails 时提示 Permission denied
• 缺少编译依赖（如 libssl-dev、zlib1g-dev）→ rbenv install 卡在 configure 阶段

rbenv + ruby-build 是当前最稳妥的安装路径

rbenv 不改系统 Ruby，所有版本装在用户目录下，切换干净、无副作用；ruby-build 插件让源码编译自动化，比手动 ./configure && make && sudo make install 少踩 80% 的坑。

关键步骤顺序不能乱：

• 先装系统依赖：sudo apt install -y git curl autoconf bison build-essential libssl-dev libyaml-dev libreadline6-dev zlib1g-dev libncurses5-dev libffi-dev libgdbm6 libgdbm-dev libdb-dev
• 再克隆 rbenv：git clone https://github.com/rbenv/rbenv.git ~/.rbenv
• 必须装 ruby-build 插件：git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build（没它，rbenv install 命令根本不存在）
• 初始化要写进 ~/.bashrc 或 ~/.zshrc：echo 'eval "$(rbenv init -)"' >> ~/.bashrc，然后 source ~/.bashrc
• 装完 Ruby 后立刻执行：rbenv rehash（否则 ruby、gem 命令找不到）

安装哪个 Ruby 版本才真正兼容 Rails 7.1+

别只看官网写的 “Ruby ≥ 3.1.0”。实际测试中，ruby-3.2.2 是目前最稳的选择：它通过了 Rails 7.1.x 全系列 CI，且 openssl、zlib 扩展默认启用，不会在 bundle install 时因 SSL 验证失败卡住。

避开这些坑：

• rbenv install 3.3.0 → 目前（2026年4月）Rails 7.1.x 尚未完全适配 3.3 的 GC 变更，部分 gem 编译报 undefined symbol: rb_gc_mark_movable
• rbenv install 3.1.4 → 可用，但某些原生扩展（如 nokogiri）需额外指定 --use-system-libraries，否则编译慢且易失败
• 用 rbenv global 3.2.2 后，务必验证：ruby -v 输出含 3.2.2，且 which ruby 指向 ~/.rbenv/versions/3.2.2/bin/ruby

Node.js 和 Yarn 不是可选项，而是 Rails 7 的硬性依赖

Rails 7 默认启用 importmap-rails，但它仍需要 node 解析 package.json 并启动开发服务器；如果选 jsbundling-rails（推荐），那 yarn 就是构建链路起点——没有它，rails server 启动后访问页面会 500，日志里全是 ExecJS::RuntimeUnavailable。

操作要点：

• Node.js 必须 ≥ 18.0.0：curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - && sudo apt-get install -y nodejs（别用 apt install nodejs，Ubuntu 仓库版本太旧）
• Yarn 要装经典版（v1）：npm install -g yarn（不是 yarn set version berry，Rails 7 的 yarn:install Rake 任务不认 v4）
• 验证：node -v 输出 v18.20.2 或更高，yarn -v 输出 1.22.19 类似格式

最容易被忽略的是：装完 Ruby、Rails、Node、Yarn 后，新建项目必须加 --skip-javascript 以外的参数才能触发 JS 工具链初始化。例如 rails new blog --javascript esbuild，否则 app/javascript 目录压根不会生成，后续加功能会反复掉坑。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~