统信UOS中ruby提示command not found，需先确认架构并卸载旧版Ruby，再用apt install ruby-full安装，配置USTC镜像源，并补装build-essential等开发依赖及ruby-dev。
您需要在统信UOS系统中运行Ruby脚本、开发Rails应用或使用Gem管理依赖，但终端输入ruby提示command not found，说明系统未预装Ruby解释器，也未配置对应开发工具链。
确认系统架构与源兼容性
统信UOS基于Debian 12，官方仓库默认提供Ruby 3.1+，但ARM64平台部分版本可能仅含Ruby 2.7。先执行uname -m确认架构：若输出aarch64，则后续步骤必须使用ARM64适配包；若为x86_64，可跳过架构校验直接进入安装。
执行apt list ruby* --installed检查是否已残留旧版Ruby——若返回结果含ruby2.7且状态为installed，需先卸载：sudo apt remove ruby2.7 ruby2.7-dev，否则新版本安装时会因文件冲突失败。
用apt安装Ruby核心组件
第一步：更新软件包索引
执行sudo apt update，确保获取最新元数据。这一步不可跳过，否则后续安装可能拉取到过期的依赖包。
第二步：安装Ruby解释器与基础开发工具
运行sudo apt install ruby-full。该包自动包含ruby、irb、gem及ruby-dev头文件，满足编译C扩展（如nokogiri）的需求。
第三步：验证安装结果
执行ruby --version && gem --version，输出类似ruby 3.1.4p223和3.4.10即成功。若gem命令报错cannot load such file -- rubygems，说明ruby-dev未随ruby-full正确安装，需手动补装：sudo apt install ruby-dev。
配置国内Gem镜像源（必做）
方法一：一键替换cruby-china镜像
执行gem sources --add https://ruby.taobao.org/ --remove https://rubygems.org/。注意：taobao镜像已于2024年停服，此命令实际指向其迁移后的https://ruby.taobao.org/重定向地址，仍可临时使用。
方法二：手动写入USTC镜像（推荐）
运行mkdir -p ~/.gem && printf "---\n:sources:\n- https://mirrors.ustc.edu.cn/rubygems/\n" > ~/.gemrc。【务必确认文件路径为~/.gemrc而非~/.gem/config】，Gem读取配置时只识别.gemrc，写错位置会导致镜像设置无效。
执行gem sources -l检查输出是否仅剩https://mirrors.ustc.edu.cn/rubygems/。若仍显示https://rubygems.org/，说明上一步写入失败，需检查~/.gemrc权限是否为644且无BOM头。
安装常用开发依赖与调试工具
若计划开发Web应用（如Rails），需补充以下组件：
执行sudo apt install build-essential zlib1g-dev libssl-dev libreadline-dev libyaml-dev libsqlite3-dev sqlite3 autoconf bison pkg-config libffi-dev。这些是编译Nokogiri、Puma、libxml等关键Gem所必需的底层库。
安装RVM（Ruby Version Manager）用于多版本管理：
执行curl -sSL https://get.rvm.io | bash -s stable，安装完成后关闭当前终端→新开终端→运行source ~/.rvm/scripts/rvm激活环境。此时rvm list known可查看可用Ruby版本，rvm install 3.2.2即可安装指定版本。
安装VS Code Ruby插件所需调试支持：
执行gem install rdebug-ide，该Gem提供远程调试桥接能力。若提示ERROR: Failed to build gem native extension，说明缺少ruby-dev，立即补装：sudo apt install ruby-dev。
