CodeGeex卸载教程:macOS彻底清除残留文件
从 macOS 中移除 CodeGeex 插件后,别以为就彻底干净了——用户级残留文件仍散落在多处。单纯拖进废纸篓远远不够,必须按以下五步手动清理:停进程、删除 Application Support、清空 Caches 与 Preferences、排查 Logs 与 Saved State、扫除隐藏配置文件,最后用 find 和 defaults 命令验证是否真正归零。
许多用户反馈,CodeGeex 插件虽已从 VS Code 的扩展列表卸载,但 Finder 中仍能搜到 com.codegeex.*.plist、~/Library/Application Support/CodeGeex 等文件,缓存目录甚至还在持续膨胀。这意味着用户级配置、支持文件及运行时缓存根本没有被清除,磁盘空间未被释放。更棘手的是,重装后会自动继承旧设置,有时还会触发签名验证失败——堪称阴魂不散。
确认 CodeGeex 是否真实安装并定位主残留路径
跳过这一步,后续清理可能误删目录或遗漏关键路径。CodeGeex 作为 VS Code 扩展生态中的本地推理插件,不遵循 macOS 应用沙盒机制,其数据默认落在用户级 Library 目录,而非 /Applications 或 ~/Library/Containers 中。
打开“访达”,按 Command + Shift + G → 输入 ~/Library/Application Support → 回车,检查是否存在名为 CodeGeex 或 codegeex 的文件夹;再依次进入 ~/Library/Caches 和 ~/Library/Preferences,用右上角搜索框搜 codegeex(注意大小写不敏感,但 .plist 文件名通常为全小写)。
若三个路径中任意一处存在匹配项,说明插件确有本地残留;若全部为空,则无需折腾——你可能遇到了其他同名工具,或纯粹是误判。
手动清除五大核心残留区
CodeGeex 不提供独立卸载器,也未注册 LaunchDaemon 或内核扩展,因此只需精准清理以下五类路径。操作顺序不可颠倒:先停进程,再删文件,否则部分缓存可能被锁定写入。
第一步:终止所有相关进程
打开“活动监视器”,顶部搜索栏输入 codegeex、ollama(CodeGeex 常依赖 Ollama 后端)、node(若其服务以 Node.js 子进程运行),选中所有匹配项 → 点击左上角“X” → “强制退出”。尤其留意 codegeex-server 或 codegeex-worker 这类进程,它们常驻后台,即使 VS Code 关闭也不会自动退出。
第二步:删除 Application Support 主数据目录
回到 ~/Library/Application Support,找到并永久删除 CodeGeex(或 codegeex)文件夹。该目录存放模型权重缓存、本地知识库索引及自定义 prompt 模板,占用空间最大。不删除的话,重装后旧模型会自动加载,等于白清。
第三步:清空 Caches 与 Preferences
进入 ~/Library/Caches,删除所有含 codegeex 的文件夹(常见的有 codegeex、com.codegeex、org.codegeex);再进入 ~/Library/Preferences,删除所有匹配 com.codegeex.*.plist 的文件(例如 com.codegeex.vscode.plist)。【注意:误删 com.apple.* 或 com.microsoft.* 开头的 plist 可能导致系统或 Office 异常,务必确认后再操作】
第四步:检查 Logs 与 Saved Application State
前往 ~/Library/Logs,搜索 codegeex,删除对应日志文件夹;再打开 ~/Library/Saved Application State,查找 codegeex 相关子目录并删除——这部分保存崩溃快照与上次会话状态,VS Code 重启时可能会尝试恢复已失效的上下文,留着就是隐患。
第五步:扫清隐藏配置文件
打开终端,执行:
ls -a ~ | grep -i codegeex
若输出类似 .codegeex、.codegeexrc 或 .codegeex_config,则运行:
rm -rf ~/.codegeex*
这类点文件经常被忽略,却记录着 API 密钥、模型路径映射等关键配置。不清除的话,新装插件会直接读取错误地址,等于白装。
验证是否真正清空
在终端中逐行执行以下三条命令:
find ~/Library -name "*codegeex*" -type d -maxdepth 3 2>/dev/null
find ~/Library -name "*codegeex*.plist" -type f 2>/dev/null
defaults read | grep -i codegeex 2>/dev/null
三条命令都应返回空结果。但凡有一条输出路径,说明仍有残留,需返回第二步重新排查对应目录。别嫌麻烦,这一步就是最后的照妖镜,扫完才算真正干净。
