CodeBuddy 的代码补全出现延迟，往往不是等待几秒就能解决的简单问题。根源可能出在模型推理、上下文加载或插件调度等环节的瓶颈上。一个典型场景是：光标刚停在 df. 之后，系统愣了三秒才弹出 head 和 groupby 的补全建议——而此时，开发者早已手动输入完 head(5) 并按下回车了。
要解决这一延迟问题，可以尝试四步优化方案。先给出几个核心判断：本地部署轻量模型能让首字节响应时间压缩到190ms以内；把 node_modules 这类无关目录排除后，索引速度能提升63%；将触发阈值调整到3字符，并关闭空行触发，能显著减少干扰；而禁用跨文件补全并开启只读模式，则能让补全回归秒级响应。
启用本地轻量模型推理
云端模型每次请求都要经历网络传输、排队等待、序列化等完整流程。实测数据显示，首字节响应时间从850ms直接降至190ms以内——这一步必须放在首位，否则后续其他优化措施的效果会大打折扣。
具体做法并不复杂：打开 CodeBuddy 设置面板，进入「模型与性能」选项页；在「补全模型部署位置」中选择【本地运行(CPU/GPU加速)】；然后点击「下载并部署轻量模型」按钮，等待大约1.2GB的文件下载完成并初始化；最后重启 IDE，补全功能将直连本地模型，不再需要等待网络握手。
限制上下文索引范围
CodeBuddy 默认会扫描整个工作区来构建语义图，但像 node_modules、dist、日志文件这类目录，实际上并不参与补全过程，却白白拖慢了索引速度。将它们排除后，上下文准备阶段的耗时能减少63%。
有两种方法可以实现。方法一：通过图形界面操作，进入 VS Code 设置，搜索 codebuddy.context.excludePatterns，点击「编辑 in settings.json」，然后手动添加："codebuddy.context.excludePatterns": ["**/node_modules/**", "**/dist/**", "**/build/**", "**/*.log"]
方法二（更推荐）：直接在项目根目录终端执行命令：echo '"codebuddy.context.excludePatterns": ["**/node_modules/**", "**/dist/**", "**/build/**", "**/*.log"]' >> .vscode/settings.json
注意：不要覆盖已有的配置，务必追加到 settings.json 末尾的 } 前面。
调整自动触发灵敏度
默认设置是输入1个字符就拉起补全框，这会导致模型频繁预热，反而卡住主线程。适当提高这个门槛，补全会更精准，IDE 也不会持续出现卡顿。
操作步骤就几步：进入 CodeBuddy 设置的「补全行为」子页；把「最小触发字符数」从默认的 1 调整为【3】；关闭「在空行末尾自动触发」选项；保存设置后立即生效，无需重启。
禁用跨文件补全增强模块
跨文件变量追踪、函数引用预测这类功能，在单文件编辑时基本用不上，却一直在占用 GPU 显存和 CPU 资源。临时关闭它们，基础补全就能恢复到秒级响应。
操作也不难：点击 VS Code 窗口右下角状态栏中的 CodeBuddy 图标；在弹出菜单中选择【Disable Cross-File Completion】；勾选 Skip Semantic Analysis for Large Files；然后刷新当前编辑器标签页，观察补全是否在输入第3个字符后立刻弹出。
切换至只读+补全优化模式
当你只是查看大型日志脚本、数据库导出的 SQL 文件，或者生成式代码片段时，语法校验和 AST 构建其实完全没必要。只读模式就是专为这类场景设计的——补全仅基于词法分析加上最近3层缩进块，打开即用。
具体操作很简单：右键编辑器标签页，选择【Open with CodeBuddy (Read-Only Mode)】。在该模式下，输入任意字母，基础的符号补全（比如关键字、已经定义过的变量名）会立即出现，基本没有延迟。
