MacBook M1安装rmagick gem报错：未声明标识符'IsGrayImage'

你遇到的编译报错use of undeclared identifier 'IsGrayImage'核心原因是Rmagick 4.2.2 与你安装的 ImageMagick 7.1.x 版本不兼容，该版本RMagick依赖的旧版ImageMagick API IsGrayImage在7.1.x版本中已被移除。另外日志显示当前Ruby版本为x86_64架构（通过Rosetta运行），而ImageMagick是arm64原生版本，架构不一致也可能引发额外的兼容问题。

方案一：降级ImageMagick到6.x版本（适配Rmagick 4.2.2） #

• 卸载当前已安装的高版本ImageMagick

arch -arm64 brew uninstall imagemagick

• 安装ImageMagick 6版本

arch -arm64 brew install imagemagick@6

• 将ImageMagick 6的路径加入系统环境变量（以zsh为例）

echo 'export PATH="/opt/homebrew/opt/imagemagick@6/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

• 验证版本适配状态

pkg-config --modversion MagickCore

正常执行后会输出6.x的版本号

• 重新执行安装

bundle install

方案二：升级Rmagick到高兼容版本（适配ImageMagick 7.1.x） #

如果不想降级ImageMagick，可直接升级Rmagick版本：

• 修改Gemfile中的rmagick版本声明为4.2.5及以上，该版本开始正式支持ImageMagick 7.1.x

gem 'rmagick', '~> 4.2.5'

• 如果你同时存在Ruby架构不一致问题，建议通过rvm/rbenv重新安装arm64原生架构的对应Ruby版本，避免架构混合引发的其他编译异常。

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