macOS Catalina执行brew upgrade qt@5遇SHA256不匹配错误求解决

• 彻底清理缓存及修复权限

  1. 删除指定的错误缓存文件：

     rm /Users/leftcoast/Library/Caches/Homebrew/downloads/3ffa4658a7ec539205ee8592c5513ae1f0252b437858c02005e3d24973f5d98a--ee7aed5e1020fa88f86777701948c8a236db4fc5.patch
     

  2. 清理所有Homebrew下载缓存：

     brew cleanup -s
     

  3. 重置缓存目录权限，避免权限异常导致下载文件损坏：

     sudo chown -R $(whoami) /Users/leftcoast/Library/Caches/Homebrew
     

• 更新Homebrew公式仓库

  1. 更新brew本体及公式：

     brew update
     

  2. 查看qt@5公式的最新信息，确认校验值是否匹配：

     brew info qt@5
     

  3. 重新执行升级：

     brew upgrade qt@5
     

• 手动下载并校验补丁文件

  1. 打开qt@5的公式编辑页面，找到对应补丁的源URL：

     brew edit qt@5
     

  2. 用curl手动下载补丁到指定缓存路径（替换下方的[补丁源URL]为公式里的实际地址）：

     curl -o /Users/leftcoast/Library/Caches/Homebrew/downloads/3ffa4658a7ec539205ee8592c5513ae1f0252b437858c02005e3d24973f5d98a--ee7aed5e1020fa88f86777701948c8a236db4fc5.patch [补丁源URL]
     

  3. 手动校验SHA256值，确认与预期值ed082ed3cac51158ede4a0f4236eedf99c0981b3451c69f34e116fa8487fa333一致：

     shasum -a 256 /Users/leftcoast/Library/Caches/Homebrew/downloads/3ffa4658a7ec539205ee8592c5513ae1f0252b437858c02005e3d24973f5d98a--ee7aed5e1020fa88f86777701948c8a236db4fc5.patch
     

  4. 校验通过后重新执行升级：

     brew upgrade qt@5
     

• 更换Homebrew镜像源（解决网络导致的文件下载损坏）

  1. 替换brew核心源为国内镜像（以清华源为例）：

     cd "$(brew --repo)"
     git remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git
     cd "$(brew --repo homebrew/core)"
     git remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git
     

  2. 清理缓存后重新升级：

     brew cleanup -s && brew upgrade qt@5
     

• 卸载后重装qt@5

  1. 卸载现有qt@5：

     brew uninstall qt@5
     

  2. 清理残留文件：

     brew cleanup qt@5
     

  3. 重新安装：

     brew install qt@5
     

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