Ubuntu/Debian 上应避免 apt 安装 Ruby，因其版本过旧且 rubygems 缺失或陈旧，易致 Gem 兼容性错误；推荐使用 rbenv 管理版本，安装依赖后克隆 rbenv 及 ruby-build，配置 shell 初始化，再安装指定 Ruby 版本并设为全局。
Ubuntu/Debian 上用 apt 装 Ruby 为什么经常出问题
系统自带的 ruby 版本太旧（比如 Ubuntu 22.04 默认是 3.0.2），很多 Gem 直接报 incompatible library version 错误；而且 apt 安装不带 rubygems 或版本极老，bundle install 会卡在 Could not find gem。
- 别直接
sudo apt install ruby，除非你明确只要跑一个老脚本且不碰 Gem - 如果已装过，先卸载干净：
sudo apt remove --purge ruby* && sudo apt autoremove - 真正要用 Rails、Jekyll 或现代 Gem，必须换版本管理器——
rbenv是最轻量、最不容易和系统冲突的选择
用 rbenv 装指定 Ruby 版本（比如 3.2.2）
rbenv 不编译 Ruby，只帮你下载、编译、切换版本，路径隔离干净，which ruby 和 ruby -v 结果可预期。
- 先装依赖：
sudo apt install -y git curl build-essential libssl-dev libreadline-dev zlib1g-dev - 拉代码到
~/.rbenv：git clone https://github.com/rbenv/rbenv.git ~/.rbenv - 启用插件：
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build - 加进 shell 初始化（以
~/.bashrc为例）：echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc，再加echo 'eval "$(rbenv init - bash)"' >> ~/.bashrc，然后source ~/.bashrc - 装版本：
rbenv install 3.2.2 && rbenv global 3.2.2，立刻生效
gem install 失败常见原因和对策
装完 Ruby 后 gem install bundler 卡住或报 SSL_connect 错误，基本是网络或证书问题，不是 Ruby 本身坏了。
- 国内用户优先换源：
gem sources --add https://mirrors.tuna.tsinghua.edu.cn/rubygems/ --remove https://rubygems.org/ - 如果提示
Permission denied @ dir_s_mkdir，说明用了sudo gem install——rbenv下绝对不要加sudo，它所有东西都在你家目录里 -
bundle install报Could not locate Gemfile？确认你在项目根目录，且该目录下真有Gemfile文件（不是Gemfile.lock） - 某些 Gem（如
nokogiri）需要额外系统库：sudo apt install -y build-essential patch ruby-dev zlib1g-dev liblzma-dev
验证环境是否真可用：别只信 ruby -v
ruby -v 输出版本只是第一步，很多问题出在 irb 进不去、require 报错、或 bundle exec 行为异常——这些才是真实运行时陷阱。
- 跑个最小验证：
ruby -e "puts RUBY_VERSION; require 'json'; puts JSON.parse('{\"a\":1}')['a']"，能输出3.2.2和1才算基础链路通 - 检查
gem是否绑定对了 Ruby：which gem应该返回~/.rbenv/shims/gem，不是/usr/bin/gem - 如果
irb启动失败，大概率是 readline 缺失，重装 Ruby：rbenv uninstall 3.2.2 && rbenv install 3.2.2（之前装时漏了libreadline-dev）
Ruby 环境最麻烦的从来不是装不上，而是装了但 shims 没生效、或系统 Ruby 和 rbenv Ruby 混着用——每次开新终端都执行一次 rbenv version，看到你设的版本才放心。
