ruby在win11上提示“不是内部或外部命令”是因未安装或path未配置；需通过rubyinstaller勾选“add ruby executables to your path”安装，验证ruby/gem版本，换清华镜像源，运行ridk install配置msys2，并可选chocolatey批量部署。
如果您在Windows 11系统上尝试运行Ruby脚本或启动Rails项目，但提示“ruby不是内部或外部命令”，则很可能是Ruby解释器未安装或未正确注册到系统环境变量。以下是针对Win11平台安装与配置Ruby开发环境的完整操作流程：
一、使用RubyInstaller一键安装Ruby与DevKit
该方法适用于绝大多数Win11用户，集成Ruby解释器、MSYS2开发工具链及RubyGems包管理器，开箱即用且兼容原生扩展编译。
1、访问RubyInstaller官网（rubyinstaller.org），点击首页“Download the latest Ruby+Devkit version”按钮。
2、下载带“x64”标识的安装包（Win11默认为64位系统；若为32位设备，请确认系统属性后选择x86版本）。
3、双击运行.exe安装程序，在安装向导中务必勾选“Add Ruby executables to your PATH”选项，否则后续命令行无法识别ruby命令。
4、在MSYS2组件安装步骤中，保持默认选择“Install MSYS2 and install/update packages”，点击继续完成安装。
二、验证Ruby与Gem基础功能
此步骤用于确认Ruby解释器和RubyGems包管理器已成功注入系统路径，并能响应终端调用。
1、按Win + R键，输入cmd打开命令提示符窗口。
2、依次执行以下两条命令：
ruby -v
gem -v
3、若两行均返回有效版本号（例如ruby 3.3.0与gem 3.5.0），说明核心组件就绪；若提示“不是内部或外部命令”，请重新运行安装程序并严格检查PATH勾选项。
三、替换RubyGems源为国内镜像加速安装
因默认源https://rubygems.org在国内访问极慢甚至超时，切换至清华镜像源可避免gem install卡死或失败。
1、在命令提示符中执行：gem sources -l，查看当前配置的源列表。
2、移除原始源：gem sources --remove https://rubygems.org/。
3、添加清华镜像源：gem sources --add https://mirrors.tuna.tsinghua.edu.cn/rubygems/。
4、再次执行gem sources -l，确认输出中仅存在清华源地址，且末尾标注(DEFAULT)。
四、初始化MSYS2并安装编译支持工具
当需安装含C扩展的gem（如nokogiri、sqlite3）时，必须确保MSYS2开发环境已就绪，否则会报错“Failed to build gem native extension”。
1、在命令提示符中执行：ridk install。
2、出现数字选项菜单后，输入3并回车，选择安装“MSYS2 and MINGW development tool chain”。
3、等待全部组件下载并解压完成，窗口自动关闭即表示初始化成功。
五、通过Chocolatey批量部署Ruby及相关工具链
该方案适合已有Chocolatey包管理器的用户，或希望统一管理多语言开发环境的进阶使用者，支持静默安装、路径自定义与版本锁定。
1、以管理员身份打开PowerShell，执行安装命令：Set-ExecutionPolicy Bypass -Scope Process -Force; irm https://chocolatey.org/install.ps1 | iex。
2、安装Ruby（含DevKit）：choco install ruby -y。
3、安装常用配套工具：choco install git nodejs python -y。
4、执行refreshenv刷新环境变量，随后运行ruby -v验证是否生效。
