Windows 11下安装Ruby on Rails失败求助：gem install rails报错

问题核心 #

执行gem install rails时，系统自动尝试安装依赖的mingw-w64-ucrt-x86_64-libyaml库，但因权限不足导致pacman无法锁定数据库，最终psych gem的原生扩展编译失败（找不到yaml.h头文件）。

解决方案 #

1. 以管理员权限运行终端 #

Windows的普通权限会限制pacman写入系统目录，右键点击开始菜单，选择「终端(管理员)」或「Windows PowerShell(管理员)」，重新执行：

gem install rails

2. 手动通过MSYS2安装libyaml #

若管理员权限仍无效，直接用Ruby自带的MSYS2终端安装依赖：

• 打开开始菜单中Ruby文件夹下的「MSYS2 UCRT64」终端
• 依次执行命令更新包数据库并安装libyaml：

  pacman -Syu
  pacman -S mingw-w64-ucrt-x86_64-libyaml
  

• 安装完成后回到PowerShell重新运行gem install rails

3. 手动指定libyaml路径编译 #

如果上述步骤仍失败，强制指定libyaml的安装路径给gem（默认路径为Ruby安装目录下的msys64\ucrt64）：

gem install rails -- --with-libyaml-dir=C:\Ruby33-x64\msys64\ucrt64

4. 确认Ruby安装包的完整性 #

确保你使用的是官方RubyInstaller安装包，而非手动编译的Ruby版本。RubyInstaller会自动配置好MSYS2环境，避免依赖缺失问题。

内容的提问来源于stack exchange，提问作者Milda