---
title: "解除安裝"
description: "Gemini CLI 解除安裝方式：npx cache、npm global、Homebrew 和 MacPorts。"
verifiedAt: "2026-05-09"
---

解除安裝方式取決於你當初怎麼執行 Gemini CLI。

> [!WARNING]
> 解除安裝 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：

```bash
rm -rf "$(npm config get cache)/_npx"
```

Windows PowerShell：

```powershell
Remove-Item -Path (Join-Path $env:LocalAppData "npm-cache\_npx") -Recurse -Force
```

## npm global

如果用全域性 npm 安裝：

```bash
npm uninstall -g @google/gemini-cli
```

## Homebrew

```bash
brew uninstall gemini-cli
```

## MacPorts

```bash
sudo port uninstall gemini-cli
```

## 解除安裝前檢查

如果只是版本舊，不一定要解除安裝，直接更新通常更合適：

```bash
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 問題：清 `_npx` cache。

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

## 清理決策

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

## 安全重置順序

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

1. 在空目錄執行 `gemini --version`，確認是否只有當前專案異常。
2. 臨時重新命名專案 `.gemini/`，判斷專案 settings、env、commands、extensions 是否導致問題。
3. 清理 `npx` cache 或解除安裝當前包管理器安裝的 CLI。
4. 重新安裝 stable，再用空目錄做一次最小啟動。
5. 只有確認全域性配置本身損壞時，才備份後處理 `~/.gemini`。

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

## 驗收方式

解除安裝後執行 `command -v gemini` 或等價命令確認入口是否還存在。重灌後執行 `gemini --version`，再啟動一個空目錄測試，確認問題是否來自程式包還是舊配置。

## 下一步

<Cards>
  <Card title="Release notes" description="解除安裝和更新前，先判斷版本渠道和已知變更。" href="/zh-Hant/docs/gemini-cli/official/08-troubleshooting-reference/83-release-notes" />
  <Card title="安裝" description="重灌時回到安裝頁，避免混用多種包管理器。" href="/zh-Hant/docs/gemini-cli/official/00-getting-started/01-installation" />
  <Card title="故障排查" description="如果解除安裝沒有解決，回到分層排障而不是繼續刪除配置。" href="/zh-Hant/docs/gemini-cli/official/08-troubleshooting-reference/81-troubleshooting" />
</Cards>

## 官方來源

- [Uninstalling Gemini CLI](https://github.com/google-gemini/gemini-cli/blob/main/docs/resources/uninstall.md)
