MacOS 10.15.7下Ruby2.6.5单独装gem成功但bundle install仍报原生扩展错误
核心根因
当前运行Bundler的Ruby环境,与手动执行gem安装时使用的Ruby环境完全割裂,不存在版本兼容或Xcode工具的核心问题。
从你提供的信息可直接定位矛盾点:
- 你手动安装
jaro_winkler时使用的是rbenv管理的2.6.5版本Ruby,gem which的返回路径/Users/{username}/.rbenv/versions/2.6.5/...已验证gem被正确安装到rbenv的gem目录下 - 但Bundler构建原生扩展时,实际调用的执行程序是MacOS系统自带的内置Ruby(路径
/System/Library/Frameworks/Ruby.framework/Versions/2.6/usr/bin/ruby),属于和rbenv环境完全独立的另一套Ruby运行时 - 系统自带的Ruby并未适配你更新后的Xcode命令行工具的SDK路径映射,才会在make阶段报找不到
ruby/config.h头文件的错误 - 由于两套环境完全隔离,rbenv目录下已经装好的gem,系统Ruby环境完全无法识别,因此才会反复提示“请先手动执行gem install命令安装对应包”,形成死循环。
排查与修复步骤
- 第一步校验当前shell的环境指向是否匹配rbenv版本:
- 执行
which ruby,正常返回值应为/Users/{username}/.rbenv/shims/ruby,若返回系统路径下的Ruby,说明rbenv的PATH加载优先级错误 - 执行
which bundle,正常返回值应为/Users/{username}/.rbenv/shims/bundle,若返回系统路径下的bundle,即为环境错配的直接证据
- 执行
- 第二步修正shell配置的rbenv加载逻辑:
- 打开对应shell的配置文件(zsh用户为
~/.zshrc,bash用户为~/.bash_profile),将rbenv的初始化代码放在所有PATH配置的最靠前位置,正确配置块为:export PATH="$HOME/.rbenv/bin:$PATH" eval "$(rbenv init -)" - 修改完成后执行
source ~/.zshrc(或对应配置文件路径)让配置即时生效
- 打开对应shell的配置文件(zsh用户为
- 第三步清理跨环境的残留缓存:
- 执行
gem uninstall jaro_winkler -v 1.5.3删除之前跨环境误安装的gem包 - 执行
bundle config unset path清理之前错误的Bundler安装路径配置
- 执行
- 重新执行
bundle install即可正常完成依赖安装。
补充提示:若修正环境后仍有原生扩展构建报错,可执行
sudo xcode-select --switch /Library/Developer/CommandLineTools重置Xcode命令行工具的SDK路径指向,解决头文件路径映射错位问题。
内容的提问来源于stack exchange,提问作者ArggBake
相关产品推荐
相关产品推荐

