free-disk-space

释放磁盘空间（macOS）

检查磁盘，清理可安全重新生成的内容；处理其他内容前先征求确认。

基本原则

• 如果有 trash 命令行工具，请使用它，而不是 rm -rf。先将内容移入废纸篓；最后提醒用户清空废纸篓。
• 优先使用工具自带的清理命令，而不是删除其目录（go clean -cache、brew cleanup --prune=all、pnpm store prune、npm cache clean --force、cargo clean）。
• 使用 df -h /System/Volumes/Data 测量磁盘空间（不要只用 df /）。
• 不要清理 GUI 应用数据。 ~/Library/Caches/<App> 和 ~/Library/Application Support/<App> 通常存有登录信息、Cookie 和历史记录。除非用户指定某个应用并接受风险，否则不要动这些内容。优先清理构建产物、修剪包管理器缓存、移除过时的工作树，以及将内容转移到外接磁盘。

工作流

1. 评估

df -h /System/Volumes/Data; ls /Volumes。记录可用空间，以及是否已挂载外接磁盘。

2. 调查

针对性地运行 du -sh ... | sort -hr，不要扫描整个 ~。常见的大项包括：

• 构建产物：target/（包括每个工作树）、node_modules/、Xcode DerivedData
• 包管理器缓存：go-build、Homebrew、pnpm/npm/pip 存储目录——通过命令行工具清理
• 大型媒体文件：CapCut、Screen Studio、Movies、Downloads
• 仅报告应用缓存和 Application Support 的大小；不要自动删除

3. 不经询问清理安全项

仅清理构建产物以及包管理器／语言工具缓存。其他所有内容（应用数据、媒体、模型权重、工具链）：汇总大小并征求确认，或建议转移到其他位置。

4. 检查 Git 工作树

检查每个工作树：是否有未提交更改？是否有独有／未推送的提交？若工作树干净，且更改已全部合并／推送，则运行 git worktree remove 和 git branch -d（绝不使用 -D）。保留并报告任何有未提交更改或领先远程分支的工作树。

5. 转移需保留的内容

使用 rsync -a → 验证大小 → 将原件移入废纸篓 → 为旧路径创建符号链接。对单个文件夹创建符号链接，不要对 ~/Movies 这类特殊目录整体创建符号链接。提醒用户应用需要在外接磁盘已挂载时才能使用。

6. 收尾

说明立即释放了多少空间、哪些内容已移入废纸篓，以及哪些内容保持不动。请用户清空废纸篓并重新检查 df。