Windows 11 ARM64环境下Ruby on Rails安装失败求助

一、具体修复步骤 #

1. 修正依赖包名并安装必要组件 #

你输入的ibxml2-devel是拼写错误，且MSYS2 ARM64环境下的依赖包需匹配架构命名规则。打开Mingw-w64 ARM64 Prompt（不要用普通MSYS2终端），执行以下命令安装Rails依赖的核心开发库：

pacman -S mingw-w64-aarch64-libxml2-devel mingw-w64-aarch64-libxslt-devel

这些库是nokogiri等Rails关联gem编译原生扩展的必需依赖。

2. 配置正确的编译环境 #

执行Ruby Installer自带的环境初始化命令，确保gem调用与ARM64 Ruby匹配的工具链：

ridk enable

该命令会自动适配PATH等环境变量，让编译器、头文件和库路径与Ruby 3.4.1的ARM64版本对齐。

3. 重新尝试安装Rails #

在配置好的终端中执行安装命令：

gem install rails -v 8.0.1

二、从mkmf.log定位问题的关键信息 #

查看mkmf.log时重点关注以下内容：

• 缺失的头文件/库：寻找类似fatal error: libxml/xmlversion.h: No such file or directory或checking for xmlParseDoc() in -lxml2... no的日志，直接指向缺失的依赖组件。
• 架构不匹配错误：如果出现gcc: error: unrecognized command-line option或编译器提示架构不兼容，说明你误用了非ARM64的MSYS2终端。
• 路径配置问题：日志会显示编译器查找头文件和库的路径，比如checking for xmlversion.h in /mingw64/include/libxml2...，若路径与你的ARM64 MSYS2安装路径不符，说明环境变量未正确配置。
• 版本兼容性问题：查找类似version mismatch或incompatible library version的提示，可能是依赖库版本过低，无法适配Ruby 3.4.1或Rails 8.0.1的要求。

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