df

唯讀

回報每個已掛載檔案系統的剩餘與已用空間。

指令: adb shell df
指令: 檔案與空間
風險: 唯讀

語法

df [-k] [-h] [-H] [-P] [-i] [<path>]

旗標與參數

token	意義
-k	1024 位元組區塊，也是把標頭標籤固定成你可以依賴的那個的旗標。
-h	人類看得懂的形式，1024 進位。
-H	人類看得懂的形式，1000 進位。
-P	POSIX 輸出：512 位元組區塊，而百分比那欄會叫 Capacity。
-i	計算 inode 而不是位元組。這時欄位裡放的是 inode 數。

範例

```
df -k /data
```
userdata 分割區的剩餘空間，單位是 KiB。
```
df -k
```
每一個已掛載的檔案系統。
```
df -h /data
```
用眼睛看很快，但不是拿來計算的數字。

輸出怎麼讀

輸出範例

Filesystem     1K-blocks      Used Available Use% Mounted on
/dev/block/dm-9 111222333  98765432  12345678  89% /data

標頭那一行「就是」單位宣告，而且單位只出現在那裡——所以要透過標頭而不是靠位置來讀欄位。`1K-blocks` 代表每個區塊 1024 位元組，`512-blocks` 是 512，`Size` 代表值被轉成人類看得懂的形式，而 `Inodes` 代表那些數字根本不是位元組。

輸出欄位

欄位	意義
1K-blocks	以 1024 位元組區塊計的總量。`-k` 與預設。
512-blocks	以 512 位元組區塊計的總量，也就是 `-P` 的輸出。
Size / Avail	來自 `-h` 或 `-H` 的人類可讀值，三位有效數字。
Use% / Capacity	已使用的百分比。標籤會隨旗標改變。
Mounted on	掛載點。它在標頭是兩個字、在每一列是一欄。
-	量不到的檔案系統。不是零。

版本與廠商注意事項

`-h` 與 `-H` 從輸出上分不出來：欄位標籤一樣、單位字母也一樣，唯一能看出來的是千位元組後綴的大小寫。人類可讀的值沒辦法告訴你是哪個基數，所以重要的時候就要求區塊單位。
shell 會把標準錯誤併進輸出，所以像 `df: /mnt/media_rw/0000-1111: No such file or directory` 這樣的行會出現在表格中間，而它的字數多到看起來像一列。真正的列，會在標頭承諾有數字的地方放著數字。
Android 5.1 及更早的 `df` 是另一套實作，標頭不同、沒有獨立的掛載點欄位，而且它不認識 `-k`——它會把那個旗標當成路徑。

這個我們有 UI

Android Storage Analyzer 會透過 USB 執行這個指令並解析回應——只要 Chromium 系瀏覽器，不必安裝 SDK，也不會上傳任何東西。

開啟 Android Storage Analyzer

指令	做什麼
du	回報一棵目錄樹占掉多少磁碟空間。
dumpsys diskstats	每個分割區的剩餘空間、一次磁碟寫入延遲的實測，以及一份快取起來的各 app 空間用量。
pm trim-caches	要求系統一直丟掉快取檔案，直到剩下你指定的空間為止。

其他檔案與空間指令

指令	做什麼
find	走過一棵目錄樹，印出符合條件的東西——大檔案、空資料夾、殘留物。
rm	刪除裝置上的一個檔案，或一棵目錄樹。

這些行為是在撰寫 Web ADB 工具背後的解析程式時，對照 AOSP、toybox 與核心原始碼查證的。真的會因 Android 版本或廠牌而異的地方，這一頁會直接說明，而不是給你一個在半數手機上都是錯的數字。

常見問題

adb shell 指令要怎麼執行？

在手機上打開開發者選項與 USB 除錯、接上線，然後從裝了 platform-tools 的機器執行 `adb shell <指令>`——或者只執行 `adb shell` 取得互動提示字元，再直接打指令、不用前綴。如果指令會輸出二進位資料（例如截圖），請改用 `adb exec-out` 而不是 `adb shell`：單純的 shell 服務會配一個終端機，而它會改寫換行位元組並毀掉資料。

adb shell 指令需要 root 嗎？

這份參考裡的都不用。它們以 `shell` 使用者身分執行，可以針對自己的 Android 使用者管理套件、讀取大多數 `dumpsys` 服務、寫入設定提供者、注入輸入，以及讀取共用儲存空間。需要 root 的是這份參考刻意避開的事：讀取其他 app 的私有資料（除了對可除錯版本使用 `run-as`）、寫入系統分割區，或直接讀 `/data/anr`。

為什麼在我的手機上輸出看起來不一樣？

不是 Android 版本就是廠商。有些旗標與欄位是從特定版本才有的，那些都在各指令頁註明了。其餘是廠商改動，而受影響最深的是 `dumpsys`：一份 dump 是除錯輸出，它的文字就是那個服務的作者最後印了什麼，而廠商既會改它也會把改動往回移植。請用名稱而不是位置來讀欄位，並把沒見過的格式當成差異而不是失敗。

可以用瀏覽器而不是終端機來跑嗎？

很多指令可以——本站的 Web ADB 工具從 Chromium 系桌面瀏覽器透過 WebUSB 和手機對話，不必安裝 SDK，也不會上傳任何東西。每一頁在有對應工具時都會連過去。有兩個限制值得知道：同一時間只有一個程式能持有 ADB 介面，所以桌面的 `adb server` 要先停掉；而 `adb forward` 與 `adb reverse` 在瀏覽器裡完全無法運作。

比較想按而不是打字？Web ADB Toolkit 會從瀏覽器透過 USB 執行這類指令。或者瀏覽全部指令。

語法