macOS 26.2 下 Homebrew 版本校验报错及升级修复全攻略

一、问题现象

将 macOS 升级至 26.2 版本后，执行任何 Homebrew 命令（尤其是核心的 brew upgrade 升级命令）均会触发版本校验报错，导致 Homebrew 完全瘫痪，无法进行任何操作。具体报错日志如下：

sudo sed -i '' '53s/^/#/' /opt/homebrew/Library/Homebrew/macos_version.rb

执行说明：

• 输入 Mac 开机密码（输入时终端不显示字符，正常输入后回车即可）；

• 终端无任何额外输出，即表示执行成功。

方案 2：手动可视化修复（备选，零失误）

若一键命令执行异常，可通过手动修改文件实现，步骤清晰且精准：

1. 打开 Homebrew 版本校验核心文件： open -e /opt/homebrew/Library/Homebrew/macos_version.rb

2. 找到文件第 53 行（编辑器左侧会显示行号），原始代码为： raise MacOSVersion::Error, "unknown or unsupported macOS version: #{@version}" unless known_version?

3. 在代码开头添加注释符 #，修改后如下： # raise MacOSVersion::Error, "unknown or unsupported macOS version: #{@version}" unless known_version?

4. 按下Command + S 保存文件，关闭编辑器即可。

四、验证修复 & 执行 Homebrew 升级

修复完成后，执行以下命令验证效果，并完成 Homebrew 升级：

1. 验证 Homebrew 是否恢复正常： brew --version若正常输出 Homebrew 版本信息，无报错，则说明修复成功。

2. 执行 Homebrew 升级（核心需求）： brew upgrade此时 brew upgrade 可正常运行，顺利完成所有软件包及 Homebrew 本身的升级。