卸载与 npx 缓存

按 npm、Homebrew、MacPorts 或 npx 来源卸载，区分程序缓存与用户状态。

This page has not been translated into English yet. The original Chinese version is shown below.

卸载方式取决于最初如何安装和运行 CLI。先确认安装来源，再使用对应包管理器；卸载程序包与清理用户会话、配置是不同操作。

全局安装

安装来源	官方卸载命令
npm 全局包	`npm uninstall -g @google/gemini-cli`
Homebrew	`brew uninstall gemini-cli`
MacPorts	`sudo port uninstall gemini-cli`

使用对应的一条即可。官方卸载页没有将这些命令描述为清除所有配置、会话历史、凭据或扩展，因此不应把移除包当成数据已经全部清理。

npx 没有为 CLI 建立永久全局安装，运行包保存在 npm 缓存中的 _npx 目录。先查询实际 npm 缓存位置：

npm config get cache

官方 macOS/Linux 清理示例为：

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

这会删除 _npx 下通过 npx 执行过的其他包缓存，并非只删除 Gemini CLI。需要保留其他缓存时，不要把这个整目录清理当成针对单个包的卸载。

Windows 官方示例使用默认 $env:LocalAppData\npm-cache\_npx，但自定义 npm cache 时路径可能不同。应先以上面的查询结果确定目标，再处理对应 _npx 目录。

需要清理会话时，先查看会话管理的保留和删除功能。不要为了卸载包而直接删除整个项目 .gemini 或用户配置目录，其中可能有需要保留的设置、规则和扩展。