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 之後。 |
需要什麼權限
一條授權過的 `adb` 連線。不用 root、不用 `su`，開發人員選項裡也沒有東西要開：`android16-release` 分支的 `packages/Shell/AndroidManifest.xml` 宣告了 `CLEAR_APP_USER_DATA` 與 `DELETE_CACHE_FILES`，正是 `clearApplicationUserData` 與 `deleteApplicationCacheFilesAsUser` 檢查的那兩個權限，所以原生版本讓 shell 使用者做這個指令的兩半都不必大費周章。這也正是它值得一個二次確認而不是聳聳肩的原因——擋在某個 app 的帳號與消失之間的，是你自己打的字，不是權限檢查。廠商版本若把其中一個宣告拿掉，指令會大聲失敗而不是安靜失敗，那是比較好的失敗方式，Android Storage Analyzer 也原樣把它傳出來。權限保護不了你的，是 Android 13 以前的解析器：在那些版本上存取檢查會過、不認識的旗標被丟掉，然後那個你沒要求的清除就成功了。
失敗訊息對照
| 訊息 | 意義 |
|---|---|
| Failed | `runClear` 在觀察者回報失敗時，寫到標準錯誤的就是這個字——套件解析不出來，或呼叫被拒絕。它同時也是 `pm clear --user 0 --cache-only <pkg>` 在 Android 12 以前設計中的結果：舊的解析器把那個旗標當成套件名稱，於是找不到東西可清。從那一行指令、在舊手機上看到這個字，代表防線守住了。 |
| Error: Unknown option: --cache-only | Android 13 的 `runClear` 會逐一走過選項，拒絕它不認識的那些。這行字違反直覺地讓人安心：舊到危險的版本根本不會印它，它會安靜收下旗標然後把全部刪光。絕對不要把「沒有這一行」當成支援這個旗標的證據——去讀 `pm help`。 |
| Exception occurred while executing 'clear': | 外層抓到 `Throwable`，底下那行會說是什麼；沒把 `CLEAR_APP_USER_DATA` 給 shell 的版本會在這裡以 `SecurityException` 現身。`classifyPmClear` 只要看到這種行就整次判定失敗，就算旁邊有 `Success` 也一樣，這樣資料還在的 app 才不會被寫進「已清除」的紀錄裡。 |
會改變什麼，以及怎麼回頭
`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，也不會上傳任何東西。
相關指令
和 pm clear 會在同一次作業裡出現的指令。
| 指令 | 做什麼 |
|---|---|
| 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 版本或廠牌而異的地方，這一頁會直接說明，而不是給你一個在半數手機上都是錯的數字。