homebrew cask安装提示“磁盘空间不足”主因是临时双倍空间需求，而非真实容量耗尽；需通过df -h定位瓶颈，brew cleanup --cask清理缓存，删除中断下载包，并重点精简xcode和docker等大占用源。
mac 上用 brew install --cask 安装应用时提示“磁盘空间不足”，通常不是因为当前可用空间真的只剩几gb，而是 homebrew cask 在下载、解压、校验、移动过程中需要**临时双倍空间**——比如安装一个 2gb 的 docker desktop，它可能先下载压缩包（~1.5gb），再解压到缓存目录（又占 ~1.5gb），最后才移入 /applications。若系统剩余空间低于这个峰值需求，就会直接报错。
快速定位真正瓶颈位置
别急着删文件，先确认空间到底被谁吃了：
- 打开终端，运行
df -h查看各卷剩余容量，重点关注/（即主磁盘）的Available值 - 用
brew cleanup清掉旧版本公式和 cask 缓存（不删已装软件，只清历史安装包） - 运行
brew --cache得到 Homebrew 缓存路径（通常是~/Library/Caches/Homebrew），进访达按大小排序，看有没有几百MB以上的残留安装包 - 安装 Disk Inventory X（
brew install --cask disk-inventory-x），可视化扫描整个磁盘，一眼锁定大文件或日志堆叠区（如~/Library/Logs、Xcode 派生数据、Docker 镜像层）
针对性释放 Cask 安装所需空间
Homebrew Cask 自身不占大空间，但它的上下游环节容易堆积：
-
清理旧版 cask 缓存：执行
brew cleanup --cask（Homebrew 4.0+ 支持），它会自动删除已安装应用的旧版本安装包；老版本可手动删~/Library/Caches/Homebrew/cask/下对应子目录 -
移除未完成的中断安装残留：检查
~/Library/Caches/Homebrew/downloads/，里面可能有半截下载的 .zip 或 .dmg，直接删掉 -
精简 Xcode 相关占用：开发者常忽略这点——Xcode 命令行工具、模拟器镜像、派生数据合计可达 30GB+。用
xcode-select --install确认 CLI 工具最小安装即可，不需要完整 Xcode IDE 也能跑 brew；若已装完整版，进 Xcode → Preferences → Locations → Command Line Tools 选最小版本，再进 Components 卸载不用的模拟器 -
检查 Docker Desktop 镜像与卷：即使没在运行，Docker 默认把镜像存在
~/Library/Containers/com.docker.docker/Data/vms/0/data/Docker.raw，这个文件可能膨胀到 20GB 以上。在 Docker Desktop 设置里关闭“Use the new Virtual Machine framework”，再点击 “Reset to factory defaults” 可安全清空
避免下次再卡在空间上
养成几个小习惯，能大幅降低重复踩坑概率：
- 安装前加个空格检查：
brew install --cask xxx && echo "✅ 安装完成" || echo "⚠️ 空间或网络异常"，失败时立刻知道是哪一环断了 - 把常用 GUI 应用写成列表批量装，减少多次解压峰值压力：
echo -e "google-chrome\nvisual-studio-code\ndocker" | xargs -I {} brew install --cask {} - 定期执行
brew autoremove（需 Homebrew 4.2+）自动卸载不再被依赖的旧 formula，连带清理其关联的 cask 构建缓存 - 如果长期开发，考虑将
~/Library/Caches/Homebrew软链接到外置 SSD（需格式化为 APFS），命令：mv ~/Library/Caches/Homebrew /Volumes/SSD/brew-cache && ln -s /Volumes/SSD/brew-cache ~/Library/Caches/Homebrew
问题本质不在 Cask 本身，而在 macOS 对临时空间的保守预估机制。看清缓存路径、盯住下载中间态、优先清理 Xcode 和 Docker 这两个“空间黑洞”，90% 的安装卡顿都能当场解决。
