MacOS Catalina执行bundle install时nokogiri安装报错求助

根因定位 #

从报错日志可直接定位到两个核心问题：

1. 执行bundle install时默认带了--use-system-libraries参数，Nokogiri 1.12.3版本编译依赖的内置libgumbo库头文件读取失败，导致找不到gumbo_parse_with_options函数
2. 项目路径/Users/zerad/coding Projects/中包含空格，部分编译工具处理带空格的路径时会出现参数截断问题，进一步导致头文件路径识别失败

解决方案 #

按顺序执行以下操作即可解决：

步骤1：清理本地已缓存的失败安装包 #

gem uninstall nokogiri -v 1.12.3
rm -rf /Users/zerad/coding\ Projects/rubyProjects/environment/testapp/vendor/cache/ruby/3.0.0/gems/nokogiri-1.12.3
rm -rf /Users/zerad/coding\ Projects/rubyProjects/environment/testapp/vendor/cache/ruby/3.0.0/extensions/x86_64-darwin-19/3.0.0/nokogiri-1.12.3

步骤2：指定Nokogiri编译参数，跳过系统库强制使用内置依赖编译 #

bundle config set --local build.nokogiri --use-system-libraries=false

步骤3：重新执行bundle安装 #

bundle install

如果执行后仍报错，优先把项目路径中的coding Projects空格去掉，改成coding_projects这类无空格命名，再重新执行上述操作即可。

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