解除安裝
Gemini CLI 解除安裝方式：npx cache、npm global、Homebrew 和 MacPorts。
📖 本篇術語速查表
| 英文 / 縮寫 | 中文 | 一句話解釋 |
|---|---|---|
| 解除安裝 | uninstall | 乾淨移除 Gemini CLI。 |
| 殘留清理 | cleanup | 清掉設定 / 快取 / 憑據。 |
| 憑據 | credential | 解除安裝時安全處理憑據。 |
不想讀完？把下面這段提示詞丟給 AI 幫你跑完——幫你乾淨地解除安裝 Gemini CLI 並清理殘留（設定、快取、憑據）。
你是 Gemini CLI 解除安裝清理顧問。
【角色】
Gemini CLI 解除安裝清理顧問，按分層定位、一次只改一個變數的原則幫我找根因，每條結論落到能照做的步驟。
【輸入】
- 為什麼要解除安裝（重灌 / 棄用 / 排障）：___
- 作業系統：___
- 是否要保留某些設定：___
- 是否有憑據需清理：___
- 經驗水平：___
【工作流程】
1. 給解除安裝步驟
2. 列出要清理的殘留（設定 / 快取 / 憑據）
3. 區分要保留和要刪的
4. 安全處理憑據
5. 給驗證清理乾淨
【輸出規範】
▌一、解除安裝步驟
▌二、殘留清理清單
▌三、保留 vs 刪除
▌四、憑據處理 + 驗證
【硬約束】
- 憑據要安全清理，不留明文
- 重要設定先備份再刪
- 確認清理乾淨不留垃圾
- 不要替我臆測原因或編造不存在的設定，資訊不全先問清
- 不確定的機制或報錯一律以官方文件為準，禁止照搬過時寫法解除安裝方式取決於你當初怎麼執行 Gemini CLI。
解除安裝 CLI 不等於刪除設定。~/.gemini、專案 .gemini/、trusted folders、settings、skills、extensions、memory 和 shell 環境變數需要單獨判斷。
先確認安裝來源
| 執行方式 | 清理物件 | 驗證命令 |
|---|---|---|
npx @google/gemini-cli | npm _npx cache | npm config get cache |
npm install -g | 全域 npm package | npm list -g @google/gemini-cli |
| Homebrew | brew formula | brew list --versions gemini-cli |
| MacPorts | port package | port installed gemini-cli |
| 原始碼執行 | 本地 clone、build 產物、shell alias | command -v gemini |
npx
npx 不會永久安裝包，而是使用 npm cache。要清理 Gemini CLI 的 npx 臨時包，需要清理 _npx cache。
macOS / Linux：
rm -rf "$(npm config get cache)/_npx"Windows PowerShell：
Remove-Item -Path (Join-Path $env:LocalAppData "npm-cache\_npx") -Recurse -Forcenpm global
如果用全域 npm 安裝：
npm uninstall -g @google/gemini-cliHomebrew
brew uninstall gemini-cliMacPorts
sudo port uninstall gemini-cli解除安裝前檢查
如果只是版本舊，不一定要解除安裝，直接更新通常更合適：
npm install -g @google/gemini-cli@latest如果 gemini 仍然指向舊版本，先查 command -v gemini 和 shell alias/function。很多“解除安裝失敗”其實是 PATH 中還有另一個安裝來源。
解除安裝不等於清空設定
解除安裝 package 只移除 CLI 程式或快取，不會自動刪除你的 ~/.gemini 設定、會話、trusted folders、settings、skills、extensions 或 memory。排查問題時要區分：
- 程式包問題：解除安裝 / 重灌 CLI。
- 設定汙染：檢查
~/.gemini/settings.json、專案.gemini/settings.json。 - 會話或 memory 問題：檢查
/memory show、session 恢復來源。 - npx cache 問題：清
_npxcache。
如果只是想重置一個專案，優先檢查專案目錄裡的 .gemini/，不要直接刪全域 ~/.gemini。全域目錄可能包含所有專案共享的設定和記憶。
清理決策
| 目標 | 推薦動作 |
|---|---|
| 想升級到最新 stable | 直接更新，不先解除安裝 |
npx 老是跑舊包 | 清 _npx cache |
| npm 全域版本壞了 | npm uninstall -g 後重灌 |
| 多安裝源衝突 | 逐個解除安裝非目標來源，再確認 command -v gemini |
| 專案設定汙染 | 臨時移開專案 .gemini/，不要直接刪全域目錄 |
| 要換賬號或認證方式 | 先看認證頁和 settings，不把解除安裝當退出登入 |
安全重置順序
如果你確實想做“乾淨重灌”，建議按影響範圍從小到大處理：
- 在空目錄執行
gemini --version，確認是否只有目前專案異常。 - 臨時重新命名專案
.gemini/，判斷專案 settings、env、commands、extensions 是否導致問題。 - 清理
npxcache 或解除安裝目前包管理器安裝的 CLI。 - 重新安裝 stable，再用空目錄做一次最小啟動。
- 只有確認全域設定本身損壞時，才備份後處理
~/.gemini。
這樣做的好處是可以保留長期設定和記憶，同時定位問題來源。直接刪除全域目錄雖然看起來快，但會把 trusted folders、skills、extensions、memory 和團隊約定一起抹掉，後續更難判斷原始問題。
驗收方式
解除安裝後執行 command -v gemini 或等價命令確認入口是否還存在。重灌後執行 gemini --version，再啟動一個空目錄測試，確認問題是否來自程式包還是舊設定。