直接用系统包管理器安装 ruby 和 rails 会导致版本过旧（如 ubuntu 的 ruby-full 仅含 3.0.x）、abi 不兼容、权限混乱及缺少编译依赖，造成 rails new 失败、bin/dev 启动报错或 bundler/setup 加载失败；推荐使用 rbenv + ruby-build 安装 ruby 3.2.2，并搭配 node.js ≥18.0.0 与 yarn v1。
直接用系统包管理器装 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:installRake 任务不认 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 目录压根不会生成，后续加功能会反复掉坑。
