qoder完全卸载需五步：一、卸载ide扩展并终止qoder相关进程；二、按系统清除用户配置目录；三、卸载全局cli与mcp组件；四、运行qoder-reset --force重置；五、清理各项目级残留文件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试卸载 Qoder，但发现重新安装后仍保留旧账户信息、AI 补全失效、配置异常或启动卡顿，则很可能是由于插件、用户数据、全局 CLI 工具、MCP 服务配置或项目级残留未被清除。以下是实现 Qoder 完全卸载与重装前残留清理的多种互斥且可独立执行的操作路径：
一、卸载 IDE 扩展并终止运行时进程
IDE 扩展是 Qoder 的主要入口，其后台服务进程（如 qoder-agent、qoder-router）可能在卸载后持续驻留内存，导致新安装版本无法初始化上下文环境。必须确保扩展卸载与进程终止同步完成。
1、打开 VS Code，按 Ctrl+Shift+X 进入扩展视图。
2、在搜索框中输入 Qoder，定位到扩展条目。
3、点击扩展右侧的齿轮图标 → 选择 卸载。
4、完全关闭 VS Code（包括系统托盘中的隐藏进程），在任务管理器中结束所有名称含 qoder 或 coder 的进程。
5、若使用 JetBrains 系列 IDE，依次点击 File → Invalidate Caches and Restart → Invalidate and Restart。
二、清除用户级配置与缓存目录
Qoder 在用户空间创建的配置目录存储设备指纹、会话快照、模型缓存及本地向量索引，损坏或跨版本混用将直接导致 AI 补全退化或身份校验失败。这些路径需按操作系统精准定位并递归删除。
1、Windows 用户请手动删除以下全部路径：
— %APPDATA%\Code\User\globalStorage\coder.qoder\
— %USERPROFILE%\.qoder\
— %APPDATA%\qoder\
2、macOS 用户请执行终端命令：
rm -rf ~/Library/Application\ Support/Code/User/globalStorage/coder.qoder/ ~/.qoder/ ~/Library/Preferences/qoder/
3、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 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
1、检查是否安装 CLI：
— Windows PowerShell 中执行 where.exe qoder
— macOS/Linux 终端中执行 which qoder
2、若返回有效路径，执行对应卸载：
— npm 全局安装：运行 npm uninstall -g qoder-cli @qoder/mcp-server
— pip 全局安装：运行 pip uninstall qoder-core mcp-sdk
— 官方二进制：删除 /usr/local/bin/qoder 及 /opt/qoder-mcp/
3、清空 MCP 默认配置目录：
— Windows：%LOCALAPPDATA%\qoder-mcp\
— macOS：~/Library/Caches/qoder-mcp/
— Linux：~/.cache/qoder-mcp/
四、执行 qoder-reset --force 一键重置
qoder-reset 是 Qoder 官方维护的跨平台重置脚本，专为覆盖式清除设计，可自动识别并删除散落在不同路径的模型缓存、会话历史、设备标识符及临时运行目录，避免手动遗漏关键项。
1、确保终端中已配置 qoder-reset 命令（若未安装，从 github.com/bunnysayzz/qoder-reset 下载最新版并赋予可执行权限）。
2、以普通用户身份运行：
qoder-reset --force
3、等待输出 Reset completed. Please restart your IDE. 后，关闭所有开发工具窗口。
4、重启前确认 ps aux | grep -i qoder（macOS/Linux）或 tasklist | findstr qoder（Windows）无任何进程返回。
五、清理项目级残留与沙盒锁文件
Qoder 在项目根目录下可能生成 .qoder/ 目录、qoder.config.json 或 .qoder-sandbox.lock 文件，这些文件携带项目专属上下文策略与权限沙盒状态，若未清理，新安装版本将继承错误的访问控制逻辑。
1、进入每个曾启用 Qoder 的项目根目录。
2、执行命令删除项目级痕迹：
— Windows：del /s /q ".qoder" "qoder.config.json" ".qoder-sandbox.lock"
— macOS/Linux：rm -rf .qoder qoder.config.json .qoder-sandbox.lock
3、检查 .gitignore 文件中是否包含 .qoder/ 条目，如有，请一并移除以防止误提交残留配置。
