pm clear

破壞性

清除某個 app 的資料——在 Android 13 之後也可以只清快取。

指令: adb shell pm clear
指令: 套件（pm）
風險: 破壞性

語法

pm clear [--user <id>] [--cache-only] <package>

旗標與參數

token	意義
--cache-onlyAndroid 13 起	只刪快取目錄，不動帳號與資料。
--user <id>	由哪個 Android 使用者失去資料。明確寫出來，是為了讓你跑的那行指令就是「清掉了什麼」的全部真相。

範例

```
pm clear --user 0 --cache-only com.example
```
在 Android 13 之後清掉一個 app 的快取。參數順序有意義，見注意事項。
```
pm clear --user 0 com.example
```
把 app 恢復成剛安裝的樣子。裡面的東西全沒了。
```
pm help
```
去問手機自己有沒有 `--cache-only`，而不是從 Android 版本推測。

輸出怎麼讀

輸出範例

Success

標準輸出是 `Success`，標準錯誤是 `Failed`，選項解析拒絕旗標時是 `Error: Unknown option: …`。`pm clear` 一定會說話，所以完全沒有輸出代表這個指令根本沒跑起來。

輸出欄位

欄位	意義
Success	資料（或快取）已刪除。
Failed	什麼都沒刪：套件無法解析，或呼叫被拒絕。
Error: Unknown option:	這個版本不認識那個旗標。會在這裡拒絕未知選項的只有 Android 13 之後。

會改變什麼，以及怎麼回頭

`pm clear <pkg>` 會刪掉那個 app 的資料庫、偏好設定、帳號與檔案。Android 沒有復原也沒有垃圾桶：app 會回到剛安裝的狀態，你得重新登入一次。`--cache-only` 是活得下來的那個版本，但它只存在於 Android 13 之後——請務必看下面那則注意，在更舊的版本上同一個旗標可能把全部清光。

版本與廠商注意事項

Android 12 以前的選項解析不會拒絕 `--cache-only`，而是「忽略」它——於是 `pm clear --cache-only com.example` 會刪掉那個 app 的全部資料並印出 `Success`。別從版本推測，去看手機自己的 `pm help` 裡有沒有這個旗標。
把 `--user 0` 放在 `--cache-only` 前面是真正的防護而不是整齊：舊的單選項解析會吃掉 `--user 0`，然後把 `--cache-only` 當成套件名稱，那解析不出來，於是指令無害地失敗，而不是把 app 清光。
原生版本上 shell 使用者有這個權限；廠商若把權限拿掉，指令會大聲失敗而不是默默成功。

這個我們有 UI

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

開啟 Android Storage Analyzer

指令	做什麼
pm trim-caches	要求系統一直丟掉快取檔案，直到剩下你指定的空間為止。
pm uninstall	移除套件，或只針對一個 Android 使用者移除——這是不用 root 也能處理掉預載 app 的方法。
dumpsys diskstats	每個分割區的剩餘空間、一次磁碟寫入延遲的實測，以及一份快取起來的各 app 空間用量。
du	回報一棵目錄樹占掉多少磁碟空間。

其他套件（pm）指令

指令	做什麼
pm list packages	列出已安裝的套件，也能一次帶出 APK 路徑、uid、版本碼與安裝來源。
pm path	印出組成某個已安裝套件的 APK 檔絕對路徑。
pm disable-user	在不移除的前提下，把套件對某個 Android 使用者關掉——比解除安裝安全，而且確定能還原。
pm install	安裝一個已經在裝置上的 APK，也就是 `adb install` 底層在做的事。
pm install-create	開一個安裝工作階段，讓 base 與它的 split 作為一個不可分割的整體一起安裝。

這些行為是在撰寫 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 執行這類指令。或者瀏覽全部指令。

語法