Qoder完全卸载教程 彻底清理残留文件与重装指南
一、卸载IDE扩展并终止运行时进程
IDE扩展是Qoder的核心入口，但其后台服务进程（如qoder-agent、qoder-router）即便扩展已卸，仍可能驻留内存，导致新版本无法正常初始化上下文环境。因此，卸载扩展和终止进程必须同步完成。
具体操作：打开VS Code，按Ctrl+Shift+X进入扩展面板；搜索Qoder定位到扩展；点击齿轮图标，选择卸载。随后完全关闭VS Code（包括系统托盘隐藏进程），在任务管理器中结束所有名称包含qoder或coder的进程。若使用JetBrains系列IDE，依次点击File → Invalidate Caches and Restart → Invalidate and Restart即可。
二、清除用户级配置与缓存目录
Qoder在用户空间生成的配置目录中存放了设备指纹、会话快照、模型缓存和本地向量索引。一旦数据损坏或跨版本混用，AI补全会退化，身份校验也会失败。需根据操作系统精准定位路径，递归删除。
Windows用户请手动删除以下完整路径：
— %APPDATA%CodeUserglobalStoragecoder.qoder
— %USERPROFILE%.qoder
— %APPDATA%qoder
macOS用户在终端执行：rm -rf ~/Library/Application Support/Code/User/globalStorage/coder.qoder/ ~/.qoder/ ~/Library/Preferences/qoder/
Linux用户执行：rm -rf ~/.config/Code/User/globalStorage/coder.qoder/ ~/.qoder/ ~/.local/share/qoder/
三、卸载全局CLI工具与MCP相关组件
若曾通过npm、pip或官方安装包部署Qoder CLI或Model Context Protocol (MCP) 服务器，其二进制文件和配置独立于IDE存在。不清理干净，新版本会调用冲突命令或连接到旧服务端点。
先检查CLI是否安装：Windows PowerShell运行where.exe qoder，macOS/Linux终端运行which qoder。若返回有效路径，按安装方式卸载——npm全局安装则运行npm uninstall -g qoder-cli @qoder/mcp-server；pip全局安装运行pip uninstall qoder-core mcp-sdk；官方二进制则直接删除/usr/local/bin/qoder和/opt/qoder-mcp/。最后清空MCP默认配置目录：Windows的%LOCALAPPDATA%qoder-mcp，macOS的~/Library/Caches/qoder-mcp/，Linux的~/.cache/qoder-mcp/。
四、执行qoder-reset --force一键重置
qoder-reset是官方维护的跨平台重置脚本，专为覆盖式清除设计，能自动识别并删除散落在各路径的模型缓存、会话历史、设备标识符和临时运行目录，避免手动遗漏关键项。先用终端确认已配置qoder-reset命令（若未安装，从github.com/bunnysayzz/qoder-reset下载最新版并赋予可执行权限）。然后以普通用户身份运行qoder-reset --force，等输出Reset completed. Please restart your IDE.后，关闭所有开发工具窗口。重启前，最好用ps aux | grep -i qoder（macOS/Linux）或tasklist | findstr qoder（Windows）确认无残留进程运行。
五、清理项目级残留与沙盒锁文件
Qoder在项目根目录下可能生成.qoder/目录、qoder.config.json或.qoder-sandbox.lock文件，这些文件携带项目专属的上下文策略与权限沙盒状态。不清理的话，新版本会继承错误的访问控制逻辑。进入每个曾启用Qoder的项目根目录，执行删除命令——Windows用del /s /q ".qoder" "qoder.config.json" ".qoder-sandbox.lock"，macOS/Linux用rm -rf .qoder qoder.config.json .qoder-sandbox.lock。最后检查.gitignore文件中是否包含.qoder/条目，若有则一并移除，防止误提交残留配置。