返回

Windows 10 Ruby 3.1.2 Nokogiri 安装失败解决

windows

Windows 10 环境下 Ruby 3.1.2 安装 Nokogiri 失败的排查与解决

在 Windows 10 系统中，使用 Ruby 3.1.2 开发 Rails 项目时，安装 Nokogiri gem 可能会遇到一些问题。通常是因为缺少必要的依赖库或配置不当造成的。下面将深入探讨这些问题，并提供相应的解决方案。

一、问题现象与原因分析

根据日志信息可以得知，错误发生在 Nokogiri 尝试编译其原生扩展时。问题出在 extconf.rb 脚本无法找到 libxml2 库。具体表现为 checking for xmlParseDoc() in -lxml2... no，以及相关的错误提示。这说明系统环境中没有正确安装或配置 libxml2，导致 Nokogiri 的编译过程失败。

日志信息还指出，即使安装了 pkg-config 工具或 gem，也无法通过 pkg-config 找到 libxml-2.0。这进一步暗示了系统没有正确设置 libxml2 的库文件和头文件路径。

二、解决方案

解决这个问题需要安装 libxml2 以及其开发相关的包，然后修改安装 nokogiri 的命令。针对问题现象和错误信息，给出以下解决方案:

方案 1：安装 libxml2 和 pkg-config

虽然已经安装 libxslt, 仍然可能需要单独安装 libxml2 以及它的开发包。还需要保证系统环境中已经正确安装了 pkg-config。

操作步骤：

  1. 使用 ridk 进入 MSYS2 环境：

    ridk exec bash

  2. 通过 pacman 安装 libxml2 和相关的开发包，以及pkg-config。

    pacman -S mingw-w64-x86_64-libxml2 mingw-w64-x86_64-libxml2-devel mingw-w64-x86_64-pkg-config

    这三个包，缺一不可。

  3. 重新安装 nokogiri, 并加入 libxml2的库和头文件路径.

    gem install nokogiri --platform ruby -- --use-system-libraries --with-xml2-include=$(pkg-config --cflags-only-I libxml-2.0 | sed 's/^-I//') --with-xml2-lib=$(pkg-config --libs-only-L libxml-2.0 | sed 's/^-L//')

  4. 确保你已经配置了系统环境，可以尝试在终端执行如下命令，检查是否存在 libxml2.

    pkg-config --cflags --libs libxml-2.0

    如果成功找到 libxml2, 这时你可以再次尝试只使用下面的指令安装。

    gem install nokogiri --platform ruby -- --use-system-libraries

方案 2：使用预编译的 Nokogiri 版本（推荐）

对开发者更友好的解决方案是使用已预编译好的Nokogiri版本。这可以避免在安装过程中处理复杂的编译问题。 RubyInstaller 自 2.4 版本开始提供了 MINGW 预编译的 gem 包，避免开发者再去处理构建本地扩展包.

操作步骤：

  1. 直接使用以下命令安装 Nokogiri。gem 会自动识别并安装已预编译的 MINGW 版本。无需任何额外的参数，

    gem install nokogiri

    这种方式大大简化了安装流程，也更容易成功。

方案3：使用 WSL

如果尝试各种解决方案都不理想。或者为了不与系统的原有库造成版本冲突。你可以尝试使用Windows Subsystem for Linux(WSL)。这是一个与windows隔离的linux 环境，不会与现有的MSYS环境产生干扰。

操作步骤：

  1. 按照Microsoft 官网安装WSL。

  2. 使用选择合适的发行版（Ubuntu，Debian）。

  3. 使用对应系统的包管理工具，安装Ruby 环境和nokogiri gem。以Ubuntu 为例，使用apt:

    sudo apt update
sudo apt install ruby-full build-essential zlib1g-dev libxml2-dev libxslt-dev
sudo gem install nokogiri

安全建议:

在软件开发时要从受信来源安装和使用软件包，在下载软件包的时候需要确认软件源，并避免潜在的威胁和漏洞。对生产环境的配置进行严格管理，防止依赖版本升级对运行环境产生冲突和故障。在配置上最好隔离运行环境。

三、额外说明

这篇解决Nokogiri gem安装问题文章中列举的方法针对大多数类似情况有效。实际环境中需要根据出现的错误来决定采取哪种方式进行解决。希望可以帮助开发人员快速的解决在 Windows 系统配置 Ruby 开发环境的问题。对于刚接触 Windows 环境下 Ruby 开发的新人，可以直接采用方案 2 或者方案3 安装nokogiri，这可能是更快的方式。当然选择方案1， 更加了解nokogiri的底层原理，可以提升对相关技术的认知水平，也未尝不是好事。