Ruby脚本调用Nokogiri遇LoadError及安装权限/编译错误求助

我之前折腾Ruby和Nokogiri的时候碰到过几乎一模一样的问题，给你几个亲测有效的解决方案，一步步来应该能搞定：

1. 先搞定gem安装的权限问题（根源） #

最初的Permission denied @ rb_sysopen是因为你用的是系统自带的Ruby，它的gem安装目录属于系统权限，普通用户没法直接写入。推荐两种解决方式：

方式A：用Ruby版本管理器（长期推荐） #

用rbenv或rvm来管理独立的Ruby环境，避免触碰系统Ruby的权限：

# 用Homebrew安装rbenv（如果没装Homebrew先装）
brew install rbenv
# 初始化rbenv，按提示把初始化命令加到你的shell配置文件（.bashrc/.zshrc）
rbenv init
# 重启终端后，安装一个稳定的Ruby版本（比如3.2.2）
rbenv install 3.2.2
# 设置这个版本为全局默认
rbenv global 3.2.2
# 现在再装nokogiri就不会有权限问题了
gem install nokogiri

方式B：临时用用户目录安装（快速应急） #

如果不想装版本管理器，用--user-install参数把gem装到用户自己的目录：

gem install nokogiri --user-install

之后要确保用户的gem可执行目录在PATH里，打开你的shell配置文件（_/.bashrc或/.zshrc），添加：

export PATH="$HOME/.gem/ruby/$(ruby -e 'puts RUBY_VERSION.match(/\d+\.\d+/)[0]')/bin:$PATH"

保存后重启终端，就能正常调用nokogiri了。

2. 解决原生扩展编译失败&mini_portile2缺失问题 #

卸载重装后出现的编译失败，大概率是之前的残留依赖或缓存搞的鬼，按以下步骤清理：

彻底清理旧依赖 #

先把nokogiri和它的核心依赖mini_portile2全卸载干净：

gem uninstall -aIx nokogiri mini_portile2

这个命令会删除所有版本的这两个gem，避免版本冲突。

清理gem缓存 #

删除下载的gem安装包缓存，避免损坏的文件干扰：

rm -rf ~/.gem/cache/nokogiri-*.gem ~/.gem/cache/mini_portile2-*.gem

更新Xcode命令行工具 #

你看到的Foundation框架警告，是因为Xcode命令行工具版本过时，导致编译环境不兼容：

# 安装/更新Xcode命令行工具
xcode-select --install
# 如果已经安装，切换到完整Xcode的开发者目录（如果有Xcode的话）
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
# 接受Xcode许可协议
sudo xcodebuild -license accept

手动安装兼容的mini_portile2 #

如果还是提示找不到mini_portile2，先手动安装和nokogiri兼容的版本（比如nokogiri 1.15.x需要mini_portile2 ~>2.8.0）：

gem install mini_portile2 -v 2.8.5
# 再安装nokogiri
gem install nokogiri

3. 处理mkmf.log的权限问题 #

如果还是碰到mkmf.log重命名失败，手动清理临时目录的日志文件：

# 删除临时目录里的mkmf.log
find /tmp -name mkmf.log -type f | xargs rm -f
# 确保临时目录权限正常
sudo chmod 1777 /tmp

完成这些步骤后，再运行你的Ruby脚本，应该就能正常加载nokogiri了。

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