在 VSCode 中安装 CodeGeeX 后,许多用户遭遇风扇狂转、编辑器卡顿如幻灯片、CPU 占用长期飙升至 60% 以上的困扰。问题的根源并非插件本身存在故障,而是其默认启用的实时语义分析和后台模型驻留机制大量吞噬系统资源。只需关闭几个核心开关并限制模型调用频率,CPU 占用即可从 60% 降至 2%,内存占用也不会超过 180MB。

首先确认 CodeGeeX 是否是 CPU 高占用的元凶。使用快捷键 Cmd+Shift+P(macOS)或 Ctrl+Shift+P(Windows/Linux),输入并运行 Developer: Show Running Extensions,在列表中查找 codegeex.codegeex 或 CodeGeeX。观察其 “CPU %” 列——若持续高于 15%,或 “Memory MB” 超过 400MB,即可确认 CodeGeeX 是导致卡顿的主要因素。
注意一个小细节:该命令必须在 CodeGeeX 处于激活状态时执行,例如已打开一个 .py 或 .js 文件。若编辑器处于静默状态,所得数据不具备参考价值。
诊断 CodeGeeX 是否导致 CPU 占用过高
最直接有效的降载操作是关闭实时语义分析和后台模型驻留。CodeGeeX 默认的“智能上下文感知”会在光标移动或切换文件时持续调用本地模型进行语义解析,这对 M 系列芯片或低配设备压力极大。打开设置(Cmd+, 或 Ctrl+,),搜索 codegeex.contextAnalysis,将其值设为 false。接着搜索 codegeex.autoStartModel,同样设为 false。完成这两步后,模型仅在你手动触发补全(如按 Ctrl+Enter)时才会加载,不再常驻内存。
【关键提醒】:两个配置必须同时关闭,只关一个时后台推理进程仍会偷偷启动。
禁用实时代码理解与后台模型驻留
CodeGeeX 默认的补全策略倾向于生成长文本,每次响应都需要完整解码和渲染,对 CPU 缓存造成巨大压力。通过限制输出长度和调用频率,可以有效缓解此问题。打开 settings.json(设置界面右上角点击“打开设置(JSON)”),在 JSON 对象中添加以下字段:
"codegeex.maxTokens": 64,
"codegeex.temperature": 0.3,
"codegeex.throttleDelayMs": 1200
其中 maxTokens 控制输出长度,64 是平衡可用性与性能的关键阈值;throttleDelayMs 强制两次自动补全之间至少间隔 1.2 秒,可有效打断高频请求循环。
限制模型调用频率与响应长度
除了上述两大核心调整,还有几个非必要功能模块值得顺手关闭,对性能提升有明显帮助。方法一:关闭行内注释生成。搜索 codegeex.enableInlineComment,设为 false。该功能依赖实时 AST 分析,在 TypeScript 或 Python 大文件中尤其容易引发卡顿。方法二:停用 Git 上下文增强。搜索 codegeex.gitContext,设为 false。它会监听 git status 变更并预加载变更文件的语义,对多数日常开发属于冗余行为。方法三:禁用侧边栏 AI 面板自动展开。搜索 codegeex.autoShowSidebar,设为 false。面板常驻会维持 WebSocket 连接和心跳检测,长期下来会增加 5%~8% 的基础 CPU 占用。
关闭不必要的功能模块
调整完成后,务必重启验证。先关闭所有 VSCode 窗口(macOS 需右键菜单栏图标 → Quit,Windows/Linux 关闭全部实例),然后重新打开工作区。再次运行 Developer: Show Running Extensions,确认 codegeex 条目的 CPU % 降至 2% 以下,Memory MB 不超过 180MB。若效果符合预期,说明问题已彻底解决。
