Mac Monterey 12下安装rmagick 4.2.4失败，求解决方法

核心原因 #

你安装的imagemagick@6是Homebrew的keg-only包，默认不会将其配置文件路径加入系统环境变量，导致pkg-config无法找到它的配置信息，进而让rmagick的编译脚本失败。

解决方案步骤 #

方法一：临时指定环境变量安装 #

• 获取imagemagick@6的安装前缀：

brew --prefix imagemagick@6

输出通常是/opt/homebrew/opt/imagemagick@6（M1/M2芯片）或/usr/local/opt/imagemagick@6（Intel芯片）。

• 临时设置PKG_CONFIG_PATH环境变量，让pkg-config能找到ImageMagick的配置：

export PKG_CONFIG_PATH=$(brew --prefix imagemagick@6)/lib/pkgconfig

• 重新执行bundle安装或直接安装gem：

bundle install
# 或者单独安装rmagick
gem install rmagick -v '4.2.4'

方法二：永久配置环境变量 #

如果不想每次安装都重复设置环境变量，可以将配置写入shell的启动文件：

• 打开你的shell配置文件（Monterey默认用zsh，对应~/.zshrc；如果用bash则是~/.bash_profile）：

open ~/.zshrc

• 在文件末尾添加以下内容：

export PKG_CONFIG_PATH=$(brew --prefix imagemagick@6)/lib/pkgconfig

• 让配置生效：

source ~/.zshrc

之后再执行bundle install即可正常安装rmagick。

备选方案：切换到ImageMagick 7 #

如果上述方法仍无效，可尝试安装ImageMagick 7（rmagick 4.x对其兼容性更好）：

• 卸载已安装的imagemagick@6：

brew uninstall imagemagick@6

• 安装最新版ImageMagick：

brew install imagemagick

• 设置环境变量并重新安装：

export PKG_CONFIG_PATH=$(brew --prefix imagemagick)/lib/pkgconfig
bundle install

额外检查（针对M1/M2芯片Mac） #

确保rbenv安装的Ruby是arm64架构：执行ruby -v，输出中应包含arm64-darwin-21字样。如果显示的是x86架构，需要重新用rbenv安装Ruby，确保是本地架构版本。

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