CodeBuddy 代码补全突然变卡，往往并非硬件性能不足。光标闪烁延迟、建议框迟迟不弹出、按键后毫无响应——这种卡顿感，比代码报错更令人沮丧。问题根源何在？简而言之，在于内存占用过高、上下文索引超载、以及插件资源竞争这三方面。幸运的是，通过以下几步配置优化，大多数情况都能得到有效缓解。
启用流式上下文分析模式
当您打开一个超大型文件——例如日志转储、自动生成代码、或单个文件超过10MB时——CodeBuddy若尝试完整解析其语法树，很可能迅速耗尽内存，甚至导致主线程卡死。实际上，CodeBuddy内置了流式分析的降级机制，但需要手动启用强化开关，才能确保稳定运行。
操作步骤并不复杂：按下 Ctrl + , 打开VS Code设置，搜索 codebuddy.largeFileMode，将其值设置为 true。需要注意的是，此处有一个关键点：必须重启工作区才能生效。请关闭当前窗口，重新使用VS Code打开该文件夹，此时补全响应时间可回落至200ms以内。
禁用高开销插件与语言服务
CodeBuddy并非唯一在后台运行的高负载插件。Auto Import、ESLint（尤其是启用了validate模式时）、以及GitLens，当您在超过2000行的文件中滚动时，这些插件会与CodeBuddy争夺AST解析资源。结果导致补全请求排队超时，让您只能干等。
如何定位问题插件？按下 Ctrl + Shift + P，输入并运行 Developer: Show Running Extensions，查看哪些插件的“启动耗时”超过100ms或“内存占用”超过300MB，然后直接将其禁用。此外，还可以进行针对性的替换：在Python项目中，可以将Pylance替换为Jedi——在设置中搜索 python.languageServer，选择 jedi。对于TypeScript项目，可以关闭 typescript.preferences.includePackageJsonAutoImports。另外，在settings.json中精简补全触发链也有助于提升性能：
"editor.suggestOnTriggerCharacters": false,
"suggest.maxVisibleSuggestions": 12,
"editor.inlineSuggest.enabled": false
调整上下文索引边界
CodeBuddy默认会扫描整个工作区以构建语义索引。一旦项目中混入了node_modules、dist、.log等文件，它会不必要地将数万行无关代码全部加载到内存中进行分析——这一步耗时可能占据补全总延迟的63%以上。换言之，大部分时间都浪费在了您并不关心的文件上。
解决方案是明确告知CodeBuddy哪些文件无需处理。打开命令面板 Ctrl + Shift + P，输入并选择 Preferences: Open Settings (JSON)，在settings.json中插入以下配置：
"codebuddy.context.excludePatterns": [
"**/node_modules/**",
"**/dist/**",
"**/build/**",
"**/*.log"
]
保存之后，右键点击CodeBuddy状态栏图标，选择 Restart Language Server。此步骤效果立竿见影，可大幅提升补全速度。
切换至只读+补全优化模式
如果您只是阅读超大型脚本、排查日志、或局部修改某个配置文件，实际上根本不需要实时语法校验和跨文件跳转功能。开启只读模式后，可以绕过AST构建，直接使用轻量级的词法补全，响应速度会快得多。
操作方法：右键点击编辑器标签页，选择 Open with CodeBuddy (Read-Only Mode)。在此模式下，输入任何字母，基础符号——如变量名、关键字、已定义的函数——会立即出现，毫无延迟。当需要编辑时，再切换回正常模式即可，非常便捷。