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 在瀏覽器裡完全無法運作。

find

唯讀

走過一棵目錄樹，印出符合條件的東西——大檔案、空資料夾、殘留物。

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

語法

find <path> [-type f|d] [-size +<N><suffix>] [-empty] [-maxdepth <n>] [-iname <pattern>] [-printf <format> | -exec stat -c <format> {} +]

旗標與參數

token	意義
-type f \| d	一般檔案，或目錄。
-size +<N><suffix>	大於 N 個單位。後綴請一定要寫：`c` 位元組、`k` KiB、`m` MiB、`g` GiB。只寫數字代表 512 位元組區塊，在新版上還會更糟。
-empty	裡面什麼都沒有的目錄，或空的檔案。
-maxdepth <n>	要往下走幾層。
-iname <pattern>	不分大小寫的名稱比對。樣式要加引號，讓裝置的 shell 不要動它。
-printf <format>Android 11 起	每個符合項印出你選的欄位：`%s` 以位元組計的大小、`%p` 路徑、`%T@` 修改時間。
-name <pattern>	`-iname` 區分大小寫的那個版本。新版的共用儲存空間比較名稱時不分大小寫，所以這兩個在那裡一致的機率比在桌面上高——這也讓 `-name` 變成一個不該從桌面帶過來的習慣。
-print0	用 NUL 位元組而不是換行分隔每一個符合項。在共用儲存空間上這不是吹毛求疵：檔名合法地可以含換行，而一份用換行分隔的清單，會把這樣一個檔案變成兩個不存在的路徑。
-exec <cmd> {} +	把一個指令跑在一行塞得下的所有符合項上。`+` 的形式能讓整趟掃描只用掉幾個行程；`;` 的形式是每個符合項開一個，在纜線上慢到看得出來，也夠容易出現競爭條件。

範例

```
find /sdcard -type f -size +100M
```
共用儲存空間裡所有大於 100 MiB 的檔案。
```
find /sdcard -type d -empty
```
空目錄——被解除安裝的 app 留下來的殘留物。

find /sdcard/Download -maxdepth 1 -type f -iname '*.apk'

你下載後就忘掉的安裝檔。

```
find /sdcard -type f -size +100M -print0
```
同一場搜尋，改用 NUL 分隔，這樣含換行的檔名就不會被切成兩個哪裡都到不了的路徑。
```
find /sdcard -type f -size +100M 2>&1
```
符合項與拒絕都在同一個串流裡，而這是唯一一種「空答案可以相信」的形式。

輸出怎麼讀

預設一行一個符合的路徑。要在同一趟裡拿到大小，Android 11 之後用 `-printf`，任何版本都可用的是 `-exec stat -c … {} +`——對每個檔案再跑一次 `stat`，在纜線上既慢又會有競爭條件。

輸出欄位

欄位	意義
<path>	一個符合項一行。
%s	以位元組計的檔案大小。
%p	路徑。
%T@	修改時間。秒之後那段不是小數而是「奈秒的數量」，所以 `…0.5` 代表五奈秒。
find: bad arg '-printf'	這是 Android 10 或更早的版本，請退回用 `-exec stat`。
find: '<path>': Permission denied	一個被跳過的目錄，在 stderr 上宣告。它會被單引號包起來，而符合的路徑永遠不會。

需要什麼權限

不需要特權，但有一個比權限本身更重要的但書。`find` 必須打開它走進去的每一個目錄，而 shell 的觸及範圍就剛好是 `adbd` 在放掉權限之前給它的那份附加群組清單——`sdcard_r`、`sdcard_rw`、`ext_data_rw`、`ext_obb_rw`——所以共用儲存空間走得進去，`/data/data` 走不進去。陷阱不在拒絕本身，而在拒絕跑去哪裡：讀不到的目錄是在 **stderr** 上宣告的，而符合的項目繼續從 stdout 出來，所以 `find /sdcard … 2>/dev/null` 會把一次不完整的掃描變成看起來完整的東西。「找過了，沒有超過 100 MiB 的檔案，而且一行錯誤都沒有」和「什麼都沒找到，同時四十次拒絕被丟掉了」，是完全不同的兩個宣稱，而只有第二個串流分得出來。兩個串流都留著，或者刻意把它們合併，但不要在一個「答案會決定下一步刪什麼」的指令上把錯誤丟掉。這裡不寫任何東西——`find` 只印路徑，後面每一個破壞性的步驟都是另外一個你先讀得到的 `rm`。Android Storage Analyzer 就建立在這個分離上：一個問題一次 `find`、大小在同一趟裡收齊所以不用再 stat 一次，而刪除清單是從真正回來的東西組出來的，不是從一個沒有人在畫面上展開過的萬用字元。

失敗訊息對照

訊息	意義
find: bad arg '-printf'	Android 10 以下：那個版本的 `find` 根本沒有 `-printf`，而且抱怨會在印出任何一個路徑之前就到，所以結果是空的而不只是少了大小那一欄。請退回 `-exec stat -c … {} +` 的形式，它在這一家族支援的每個版本上都給得出同樣那三個欄位。
find: '/sdcard/Android/data/com.example': Permission denied	有一個目錄打不開；走訪的其他部分不受影響，照樣繼續印。路徑會被單引號包起來，而那是把這一行和符合項分開的可靠方法，因為符合的路徑永遠是光著印出來的。如果你把兩個串流合在一起，那對引號是你唯一的標記。
find: bad -type 'x'	`-type` 只吃一個字母——`f` 是一般檔案、`d` 是目錄——其他任何東西都會讓指令在走訪任何地方之前停住。什麼都沒搜尋，所以這裡的空結果代表那個問題根本沒被問出口。
find: '-size' needs 1 arg	一個需要值的判斷式被寫成沒有值，通常是因為外層的 shell 在展開什麼東西的時候把那個值吞掉了。把參數加上引號。和 `-type` 一樣，這發生在語法檢查那一趟，所以連一個目錄都沒被打開過。
find: big not [+-]N	交給數值判斷式的那個值，不是一個可以帶正負號的數字。`-size` 要的是 `+100M`、`-100M` 或一個純數量，而它引回來的那個字就是你的 shell 實際送出去的東西——一個展開成某個檔名的萬用字元，就是這樣站到了門檻該站的位置上。

版本與廠商注意事項

Android 的 `find` 是 toybox 而不是 GNU，`-size` 的行為也不一樣：單位的乘法只在參數以數字結尾時才套用。寫了明確後綴之後，比較的直接就是位元組，也不會有向上取整到整個單位的事。
只寫 `-size +100` 是等著出事。在 Android 10 到 14 上它代表 100 乘 512 位元組；在更新的上游程式碼裡內部單位是負的，於是 `+N` 會符合裝置上的每一個檔案。
`m` 是 1024 的平方而不是一百萬。只有在結尾加 `d` 才會切換成 1000 的次方。
`-type f` 要明確寫出來。`-size` 隱含一般檔案這件事，比這一家族支援的任何出貨版 Android 都新。
拒絕從 stderr 出來、符合項從 stdout 出來，所以把 stderr 消音等於把「我不被允許去那裡看」改寫成「那裡什麼都沒有」。這是這一頁上最貴的錯誤，因為掃描之後的下一步，通常是照著結果挑東西刪掉。
`-printf` 是隨 Android 11 的 toybox 進來的，在 `android14-release` 與 `android15-release` 的原始碼上依然存在。Android 10 以下會回 `find: bad arg '-printf'` 而且什麼都不印，所以在舊手機上遇到空的掃描結果，在錯誤串流開口之前，都當成指令失敗。

這個我們有 UI

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

開啟 Android Storage Analyzer

指令	做什麼
du	回報一棵目錄樹占掉多少磁碟空間。
df	回報每個已掛載檔案系統的剩餘與已用空間。
rm	刪除裝置上的一個檔案，或一棵目錄樹。
dumpsys diskstats	每個分割區的剩餘空間、一次磁碟寫入延遲的實測，以及一份快取起來的各 app 空間用量。