du
唯讀回報一棵目錄樹占掉多少磁碟空間。
- 指令
- adb shell du
- 指令
- 檔案與空間
- 風險
- 唯讀
語法
du [-k] [-m] [-K] [-b] [-a] [-s] [-d <depth>] [-h] <path>旗標與參數
| token | 意義 |
|---|---|
| -k | 以 1024 位元組為單位印出。這本來就是預設，寫出來是為了講明白。 |
| -m | 以 1 MiB 為單位印出。 |
| -K | 以 512 位元組為單位印出。 |
| -b | 印出檔案的表面大小而不是實際占用的區塊。 |
| -s | 每個參數只給一個總數，不印每個目錄的那些行。 |
| -a | 把檔案也算進來，不只是目錄。 |
| -d <n> | 限制深度。參數自己是深度 0，所以 `-d 1` 會印出參數與它的直接子項。 |
| -h | 人類看得懂的大小。讀起來方便，解析起來不精確。 |
| -c | 在所有東西之後補一行總計。它的路徑欄放的是 `total` 這個字面字而不是目錄，這讓解析器不用數行數就能把它和真正的列分開。 |
| -x | 拒絕跨到另一個檔案系統上。這在手機上很重要：共用儲存空間與 userdata 分割區是分開的掛載點，而一趟從兩者之上開始的走訪，可能會把同一批區塊用兩個不同的名字算兩次。 |
| -l | 有硬連結的檔案，每一個連結各算一次，而不是全部只算一次。預設是依 inode 去重，那才是「我刪掉能拿回多少」的誠實答案。 |
範例
du -k -d 2 /sdcard共用儲存空間的前兩層，單位是 KiB。
du -k -s /sdcard/DCIM相機膠捲的總量，一個數字。
du -k -d 1 /sdcard/Android/data各 app 的資料目錄，讀不讀得到取決於 Android 版本。
du -k -d 1 /data/local/tmp一個 shell 完全擁有的目錄，所以不會出現任何拒絕，總數也就確定是完整的。
du -k -s -c /sdcard/DCIM /sdcard/Download兩個總數再加一行加總的 `total`，比自己用手加便宜，而且不可能和它們四捨五入得不一樣。
輸出怎麼讀
輸出範例
12048 /sdcard/DCIM/Camera
12456 /sdcard/DCIM
348920 /sdcard一個大小、一個 tab、一個路徑，一個目錄一行，而且是後序的，所以被包含的子目錄會排在父目錄前面。分隔符號是 tab，而且只有第一個算數——這正是檔名可以含空白（規格上也可以含 tab）而不會壞掉的原因。不要用空白去切這些行。
輸出欄位
| 欄位 | 意義 |
|---|---|
| <size> | 以旗標指定的單位計算，預設是 1024 位元組區塊。 |
| <tab> | 唯一的欄位分隔符號。 |
| <path> | 裝置上原本的目錄名稱。 |
| total | `-c` 的總計那一行。它的路徑就是那個單字，不是目錄。 |
| du: <path>: Permission denied | 在 stderr 上，和表格交錯出現。代表一個被跳過的目錄，也代表每一個包著它的總數都是低估的。 |
需要什麼權限
不用 root、不用 `adb root`，開發者選項裡除了 USB 偵錯也沒有東西要打開。真正決定你能量到多少樹的，是 `adbd` 在放掉權限之前給 `shell` 使用者的那份群組清單：`packages/modules/adb/daemon/main.cpp` 把 `sdcard_r`、`sdcard_rw`、`ext_data_rw` 與 `ext_obb_rw` 列在附加 gid 裡，這正是為什麼從一條線量共用儲存空間——在多數版本上連 `/sdcard/Android/data` 一起——乾乾淨淨，而同一支手機上的普通 app 兩邊都會被拒絕。shell 仍然打不開的是 `/data/data` 與 `/data/user/0` 底下的 app 私有儲存空間；把 `du` 指過去只會得到一整頁的拒絕而不是一個數字，而不用 root 進去的方法是對可除錯的套件下 `run-as`。這裡不寫任何東西：指令只是打開目錄、把核心回報的區塊數加起來，然後印出來。它路上遇到的拒絕也不是致命的——目錄走訪器會回報每一個讀不到的目錄然後繼續——所以一個夾雜著錯誤產出的總數是「部分」總數，而唯一會把這件事講出來的地方是結束碼。Android Storage Analyzer 一次只往下鑽一層正是因為如此：被拒絕的子樹會以一個明顯的洞留在畫面上，而不是被默默併進包著它的東西裡。
失敗訊息對照
| 訊息 | 意義 |
|---|---|
| du: /sdcard/Android/data/com.example: Permission denied | 走訪器打不開那個目錄，在 stderr 上把它指名之後就繼續走。已經印出來的每一列都還是對的；包著它的那個目錄的總數，只是少了裡面那些東西。在 Android 11 以上，這些各 app 目錄裡 shell 能打開哪幾個，同時取決於版本與廠商，所以總數與拒絕混在一起是常態，不是這次執行壞掉了。 |
| du: /sdcard/nope: No such file or directory | 參數本身就沒辦法被檢視，這和上面那個是不一樣的失敗：什麼都沒量到，連一列都沒印。幾乎都是路徑拼錯——新版共用儲存空間透過 FUSE 那層比較名稱時不分大小寫，但沒有任何東西會去修正一個根本就寫錯的名字。 |
| du: Missing argument to -d (see "du --help") | `-d` 要深度另外寫成一個字。toybox 的選項解析器在 `du` 自己開跑之前就丟出這個，所以什麼都沒量到。後綴的 `(see "… --help")` 是那個解析器加上去的，這讓它變成一個可靠的標記：帶著它的一行永遠是參數的錯，不會是檔案系統的錯。 |
| du: -d < 0 (see "du --help") | `-d` 宣告成 `d#<0`，也就是下限為 0 的數字，所以負的深度就是超出範圍，什麼都不會被量到。會撞上這一行的通常是伸手去打 `-d -1` 的人，因為 -1 正是 `du` 內部拿來表示「不限深度」的值；但真的想不限深度，是把 `-d` 整個拿掉，不是把那個數字傳進去。順便記住不會出現訊息的那一邊：`-h`、`-k`、`-K` 與 `-m` 是後蓋前的群組，不是互斥群組，所以 `du -k -h` 會被安靜地接受，你寫在後面的那個旗標贏。 |
版本與廠商注意事項
- 預設單位是 1024 位元組的區塊，而除法是「向上取整」的，所以一個 1 位元組的檔案會報成 1，而裝了一萬個小檔案的目錄報出來遠大於裡面的位元組總量。那確實是它占掉的磁碟量——你在決定刪什麼的時候要問的正是這個——但它不是檔案大小的總和。另一個問題由 `-b` 回答。
- `-h` 方便但有歧義：只留下三位有效數字，而且在千位元組後綴以上，除以 1000 或除以 1024 印出來的字母是一樣的。數字重要時就要求區塊單位。
- 混在輸出裡的 `du: …: Permission denied` 是真正的發現而不是雜訊。Android 11 之後，shell 讀取共用儲存空間底下各 app 目錄的能力取決於版本與廠牌。
- `adbd` 給 shell 的那幾個附加群組——`sdcard_r`、`sdcard_rw`、`ext_data_rw`、`ext_obb_rw`——才是共用儲存空間能從一條線上被量出來的原因。`du` 內部不會去要求任何權限，也沒有任何東西能給它權限。
- 一個被拒絕的目錄不會終止走訪，所以一次印出錯誤的執行同樣印出了總數，而那些總數短少的就是它打不開的部分。把 stderr 收下來，否則這個短少完全看不見。
這個我們有 UI
Android Storage Analyzer 會透過 USB 執行這個指令並解析回應——只要 Chromium 系瀏覽器，不必安裝 SDK，也不會上傳任何東西。
相關指令
和 du 會在同一次作業裡出現的指令。
| 指令 | 做什麼 |
|---|---|
| df | 回報每個已掛載檔案系統的剩餘與已用空間。 |
| find | 走過一棵目錄樹，印出符合條件的東西——大檔案、空資料夾、殘留物。 |
| dumpsys diskstats | 每個分割區的剩餘空間、一次磁碟寫入延遲的實測，以及一份快取起來的各 app 空間用量。 |
| rm | 刪除裝置上的一個檔案，或一棵目錄樹。 |
這些行為是在撰寫 Web ADB 工具背後的解析程式時，對照 AOSP、toybox 與核心原始碼查證的。真的會因 Android 版本或廠牌而異的地方，這一頁會直接說明，而不是給你一個在半數手機上都是錯的數字。