mac上brew install --cask报错主因是网络超时、sha-256校验失败、gatekeeper权限拦截或cask已移除；需分别切换中科大镜像源、清理缓存重下、右键打开绕过验证、检查拼写或改用formula安装。
macos 上用 brew install --cask 安装软件报错，多数不是命令写错了，而是背后几个关键环节出了问题：网络连不上、校验不通过、权限不够，或者 cask 本身已失效。下面分四类常见报错，直接说清原因和怎么动手解决。
网络超时或连接失败（如 curl: (7) Failed to connect）
根本原因是 Homebrew 默认从 GitHub 或境外服务器拉取元数据和安装包，国内直连极不稳定。解决核心是换国内镜像源：
- 切换主仓库、core 和 cask 的 Git 远程地址为中科大源：
git -C "$(brew --repo)" remote set-url origin https://mirrors.ustc.edu.cn/brew.gitgit -C "$(brew --repo homebrew/core)" remote set-url origin https://mirrors.ustc.edu.cn/homebrew-core.gitgit -C "$(brew --repo homebrew/cask)" remote set-url origin https://mirrors.ustc.edu.cn/homebrew-cask.git - 设置二进制包下载镜像：
echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles' >> ~/.zshrc && source ~/.zshrc - 执行
brew update验证是否秒完成——成功即说明镜像生效
SHA-256 校验和不匹配
这是 Homebrew 的安全保护机制，说明下载的文件和 Cask 脚本里记录的哈希值对不上。不要跳过校验，按顺序排查：
- 先清理对应缓存文件：
brew --cache your-app-name查出路径，手动删掉那个 .dmg 或 .zip 文件 - 或用
brew fetch --force your-app-name强制重下并显示新校验值 - 如果重试后仍不匹配，运行
brew info your-app-name看当前记录的 url 和 sha256，再打开brew home your-app-name对比官网实际发布的版本和下载链接——若 URL 或版本变了，说明 Cask 元数据过时，需提 PR 更新；若版本没变但哈希变了，可能是上游异常，暂不宜安装
权限拒绝或 Gatekeeper 拒绝打开
安装成功但双击打不开，提示“已损坏”或“无法验证开发者”，通常不是 Cask 的问题，而是 macOS 的安全机制在起作用：
- 首次打开时右键点击 App → “打开”，绕过 Gatekeeper 一次即可（系统会记住信任）
- 若提示“权限被拒绝”，检查
/usr/local/Caskroom/目录归属：sudo chown -R $(whoami) /usr/local/Caskroom - 个别应用（如 WeChat、QQ）安装后图标不显示，可尝试重启 Finder：
killall Finder
Cask 不可用或找不到（No Cask with this name exists）
说明这个软件名已从官方 cask 仓库移除，常见于 Google、Android 官方工具链调整后：
- 先确认拼写是否正确，比如
visualstudiocode不是vscode - 运行
brew search keyword查找近似名，例如brew search android可能返回android-platform-tools已被移除，但android-sdk仍存在 - 部分工具已改用 formula 安装，比如 adb 现在应走
brew install android-platform-tools（注意：不是--cask） - 也可临时启用社区维护的第三方 tap，如
brew tap homebrew/cask-versions获取 beta 版本
