Ubuntu/Debian用apt装Ruby版本旧因官方源绑定系统稳定策略，应使用rbenv或asdf管理；CentOS/RHEL仓库报错需确认系统状态并禁用失效源；gem权限错误须切换至用户级Ruby；rails new卡住常因缺失sqlite3-dev等开发包。
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 目录。
