| name | disk-free |
| description | macOS のストレージ逼迫を解消する。まず diskutil / df で「実際にどのボリューム・領域が容量を食っているか」を正しく計測し（APFS は複数ボリュームが1コンテナを共有し、symlink/hardlink/snapshot で du の数字がブレるため）、その後に項目別の解放手順を適用する。『Macのストレージを掃除したい』『容量が足りない』『どこが容量を食っているか分からない』ときに使う。解放手順は items/ 配下に項目ごとの独立ファイルとして並んでおり、新しい手段は items/ にファイルを足すだけで拡張できる。 |
disk-free — macOS ストレージ解放
macOS のディスク逼迫を「正しく計測 → 項目別に解放」の2段で片付ける。
計測が分かりにくいのは、APFS では複数ボリューム（Data / Nix Store / VM / Preboot…）が
1つのコンテナを共有しており、さらに symlink・hardlink・APFS clone・snapshot・
purgeable のせいで du の数字が実際の物理消費とズレるため。まず物理の真実を掴む。
手順
STEP 1. 現状を計測する（diskutil / df）
物理消費の唯一の真実はボリューム単位の "Capacity Consumed"。フォルダ du の合計ではなくこちらを基準にする。
diskutil apfs list | grep -iE "Capacity|Name|Snapshot"
df -h / /System/Volumes/Data
diskutil info /System/Volumes/Data | grep -iE "Used|Free|Purgeable|Capacity"
ここで「ホームの外」「別ボリューム（/nix など）」に巨大な消費が無いかを最初に見る。
Finder でホームを見るだけでは別ボリュームの消費に気づけない。
STEP 2. フォルダ単位で内訳を出す（du の注意点つき）
du -shx ~/* ~/.* 2>/dev/null | sort -rh | head -20
sudo du -shx /Applications /Library /opt /usr/local /private/var 2>/dev/null | sort -rh
sudo du -shx /System/Volumes/Data 2>/dev/null
du の数字がズレる理由（計測時に必ず意識する）:
- Top-N の切り捨て:
head -15 等で上位だけ見ると、中小ディレクトリの裾野が合計から漏れる。
「内訳の合計 ≠ ボリューム総量」になったらまずこれを疑う。
- hardlink: 同一
du ツリー内は1回だけカウント（正）。ただし別々に du を回すと二重計上する。
- APFS clone: 実体は共有でもフルサイズで計上され過大に出る。
- snapshot / purgeable / メタデータ:
du には原理的に見えないが物理ブロックは食う。
下のコマンドで別途確認する。
tmutil listlocalsnapshots /
diskutil info / | grep -i purgeable
GUI で見るなら「アクティビティモニタ」ではなく GrandPerspective / DaisyDisk / ncdu -x /
dust（いずれも hardlink 認識）。
STEP 3. 項目別に解放する
items/ 配下に項目ごとの独立した解放手順がある。STEP 1–2 で見つかった大物に対応する
ファイルを開いて適用する。各ファイルは自己完結しており、互いに依存しない。
新しい解放手段を足すときは items/<topic>.md を1ファイル追加し、この表に1行加えるだけ。
既存項目には触れない（並列に書ける）。今後の候補: Xcode ~/Library/Developer、
brew cleanup、/usr/local/texlive、APFS スナップショット、各種 Caches など。
STEP 4. 効果を実測する
解放コマンドの自己申告（"X GiB freed" 等）を鵜呑みにせず、STEP 1 と同じ
diskutil info / df -h で Before/After を比較して報告する。
原則
- 計測してから消す。 何が容量を食っているか確定する前に削除手順を走らせない。
- 物理の真実はボリューム単位（diskutil Capacity Consumed / df Avail）。 du の合計は補助。
- 消す前に正体を確認する。 実行中アプリの一時領域（
/private/var/folders 等）や
使用中のスワップ（VM ボリューム）は手動 rm しない。
- root 権限が要る操作はユーザーに実行してもらう（
! sudo ... を提案）。勝手に sudo を試さない。
