卸载 Gemini CLI 的方法取决于安装方式：用 npx 运行过的需要清理 _npx 缓存目录，全局 npm 安装用 npm uninstall -g @google/gemini-cli，Homebrew 安装用 brew uninstall gemini-cli，MacPorts 用 sudo port uninstall gemini-cli。本页提供各方式在 macOS/Linux/Windows 上的完整命令。

卸载 Gemini CLI

根据你的安装方式选择对应的卸载方法。

方式一：npx 运行方式（清理缓存）

如果你是通过 npx @google/gemini-cli 运行的（而不是全局安装），需要清理 npx 临时缓存：

macOS / Linux：

# npx 缓存通常在 ~/.npm/_npx
rm -rf "$(npm config get cache)/_npx"

Windows（PowerShell）：

# npx 缓存通常在 %LocalAppData%\npm-cache\_npx
Remove-Item -Path (Join-Path $env:LocalAppData "npm-cache\_npx") -Recurse -Force

这会清除 npx 的所有临时缓存（不只是 Gemini CLI），其他通过 npx 运行过的包也会被清除。

方式二：npm 全局安装

如果你通过 npm install -g @google/gemini-cli 全局安装的：

npm uninstall -g @google/gemini-cli

这会完全从系统中移除 Gemini CLI 包。

方式三：Homebrew（macOS）

如果通过 brew install gemini-cli 安装的：

brew uninstall gemini-cli

方式四：MacPorts（macOS）

如果通过 sudo port install gemini-cli 安装的：

sudo port uninstall gemini-cli

清理配置和数据文件（可选）

卸载程序本身后，如果想彻底删除所有配置、历史记录和缓存数据：

# 删除全局配置目录（包含 settings.json、Skills、命令、会话历史）
rm -rf ~/.gemini

Windows（PowerShell）：

Remove-Item -Path "$env:USERPROFILE\.gemini" -Recurse -Force

注意：这会永久删除你所有的会话历史、自定义 Skills、自定义命令和配置。如果以后想重新安装，建议先备份 ~/.gemini/settings.json 和 ~/.gemini/skills/。

常见问题

Q: 卸载后重新安装会恢复设置吗？

A: 只要你没有删除 ~/.gemini 目录，重新安装后所有设置、技能和命令都会自动恢复。如果已经删除了，需要重新配置。

Q: 怎么确认 Gemini CLI 已经完全卸载？

A: 执行 gemini --version，如果提示"command not found"（或 Windows 的"不是内部或外部命令"），说明已成功卸载。

Q: 卸载会影响其他 Google 产品吗？

A: 不会。Gemini CLI 是独立的 npm 包，卸载它不会影响 Google Chrome、Gmail 等其他 Google 产品，也不会影响 Google Cloud SDK 或其他 Google CLI 工具。