解除安裝

解除安裝方式取決於你當初怎麼執行 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 不會永久安裝包，而是使用 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 -Force

如果用全域性 npm 安裝：

npm uninstall -g @google/gemini-cli

brew uninstall gemini-cli

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。排查問題時要區分：

如果只是想重置一個專案，優先檢查專案目錄裡的 .gemini/，不要直接刪全域性 ~/.gemini。全域性目錄可能包含所有專案共享的配置和記憶。

目標	推薦動作
想升級到最新 stable	直接更新，不先解除安裝
`npx` 老是跑舊包	清 `_npx` cache
npm 全域性版本壞了	`npm uninstall -g` 後重灌
多安裝源衝突	逐個解除安裝非目標來源，再確認 `command -v gemini`
專案配置汙染	臨時移開專案 `.gemini/`，不要直接刪全域性目錄
要換賬號或認證方式	先看認證頁和 settings，不把解除安裝當退出登入

如果你確實想做“乾淨重灌”，建議按影響範圍從小到大處理：

這樣做的好處是可以保留長期配置和記憶，同時定位問題來源。直接刪除全域性目錄雖然看起來快，但會把 trusted folders、skills、extensions、memory 和團隊約定一起抹掉，後續更難判斷原始問題。