卸载与 npx 缓存
按 npm、Homebrew、MacPorts 或 npx 来源卸载，区分程序缓存与用户状态。
卸载方式取决于最初如何安装和运行 CLI。先确认安装来源，再使用对应包管理器；卸载程序包与清理用户会话、配置是不同操作。
全局安装
| 安装来源 | 官方卸载命令 |
|---|---|
| npm 全局包 | npm uninstall -g @google/gemini-cli |
| Homebrew | brew uninstall gemini-cli |
| MacPorts | sudo port uninstall gemini-cli |
使用对应的一条即可。官方卸载页没有将这些命令描述为清除所有配置、会话历史、凭据或扩展，因此不应把移除包当成数据已经全部清理。
npx 临时缓存
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 或用户配置目录，其中可能有需要保留的设置、规则和扩展。