brew使用报错

解决 Homebrew 安装软件时的 “Failed to upgrade Homebrew Portable Ruby” 错误

当使用 brew 安装软件时遇到 “Checksum mismatch” 并导致 “Failed to upgrade Homebrew Portable Ruby” 错误，通常是由于缓存的 Ruby 安装包损坏或校验不一致导致的。以下是详细的解决步骤：

错误原因分析

从错误信息可以看到：

• 预期的校验和（Checksum）与实际下载文件的校验和不匹配
• 问题文件是缓存中的 portable-ruby-2.6.8.yosemite.bottle.tar.gz
• 这通常是因为下载过程中断、文件损坏或镜像源同步问题导致的

解决方案：删除损坏的缓存文件

1. 删除错误提示中指定的缓存文件
   执行错误信息中建议的删除命令（路径需根据你的实际情况修改）：

   rm -rf /Users/zhanghe/Library/Caches/Homebrew/portable-ruby-2.6.8.yosemite.bottle.tar.gz

2. 重新运行安装命令
   再次尝试安装你需要的软件（以 Docker 为例）：

   brew install --cask --appdir=/Applications docker

   此时 Homebrew 会重新下载完整的 Ruby 安装包，由于删除了损坏的缓存，通常能解决校验和不匹配的问题。

若问题依旧：更新 Homebrew 并清理缓存

如果上述方法无效，可以尝试更新 Homebrew 并清理所有缓存：

1. 更新 Homebrew

   brew update

2. 清理所有缓存文件

   brew cleanup

1. 再次尝试安装

   brew install --cask --appdir=/Applications docker