CodeBuddy在大型项目中卡顿的核心原因是上下文索引过载、模型调用频繁、文件规模超限及插件与IDE主线程资源争抢，需通过分层干预优化：限制语义索引范围、启用本地轻量模型、关闭跨文件增强模块、调整触发策略、对超大文件启用流式分析模式。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeBuddy 在大型项目中卡顿，核心原因通常是上下文索引过载、模型调用频繁、文件规模超出默认处理能力，以及插件与 IDE 主线程资源争抢。这不是单纯“电脑慢”或“网络差”的问题，而是工具在高复杂度场景下的策略适配问题。解决的关键在于分层干预：先保基础响应，再提补全质量，最后稳长期运行。
限制语义索引范围，避免扫描无关文件
默认情况下，CodeBuddy 会遍历整个工作区构建符号索引，遇到 node_modules、dist、logs 等目录时，不仅耗时，还会把大量无效符号塞进内存，直接拖慢补全触发和跳转响应。
- 打开 VS Code 命令面板（Ctrl+Shift+P 或 Cmd+Shift+P），输入并选择「Preferences: Open Settings (JSON)」
- 在 settings.json 中添加或修改以下配置：
"codebuddy.context.excludePatterns": [ "**/node_modules/**", "**/dist/**", "**/build/**", "**/out/**", "**/*.log", "**/coverage/**", "**/target/**" ]
保存后重启插件服务（右键 CodeBuddy 状态栏图标 → Reload Extension）。实测可减少约 63% 的上下文准备时间，对含 500+ 文件的前端项目尤为明显。
启用本地轻量模型，切断云端延迟依赖
每次补全都走公网请求，遇上高峰时段或跨区域节点，首字节响应可能超过 800ms，叠加多次触发就造成明显卡顿。本地模型能彻底规避网络抖动，且推理更可控。
- 进入 CodeBuddy 设置 → 「模型与性能」页
- 将「补全模型部署位置」设为「本地运行（CPU 加速）」
- 点击「下载并部署轻量模型」，等待约 1.2GB 模型文件完成加载（首次需 5–10 分钟）
- 重启 VS Code，补全平均响应可稳定在 190ms 内，IDE 主线程不再频繁冻结
注意：若机器有 NVIDIA GPU，可在同一页面开启 CUDA 加速，速度还能再提升 30% 左右。
关闭跨文件增强模块，降低单次计算负载
“跨文件变量追踪”“函数引用预测”这类功能在小型项目中很实用，但在大型项目里，它们会强制解析数十个关联文件的 AST，极易引发 CPU 尖峰和内存溢出。
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
- 点击右下角 CodeBuddy 图标 → 弹出菜单中勾选「Disable Cross-File Completion」
- 同时启用「Skip Semantic Analysis for Large Files」选项
- 刷新当前编辑器标签页，观察补全弹窗是否恢复即时响应
该操作不会影响基础符号补全（如类名、方法名、关键字），只暂停高开销的语义推导，适合日常开发阶段使用；需要深度分析时再临时开启即可。
调整触发策略，减少无效模型预热
默认设置下，只要输入一个字母就尝试补全，导致模型频繁加载、释放，反而加剧卡顿。尤其在大型项目中，这种“高频低效触发”是隐形负担。
- 进入 CodeBuddy 设置 → 「补全行为」页
- 将「最小触发字符数」从 1 改为 2 或 3
- 关闭「在空行末尾自动触发」和「括号后立即触发」两项
- 保存后，补全仅在有明确意图（如输入
user.或api.）时激活，准确率上升，主线程压力显著下降
这个改动对 TypeScript 和 Java 项目效果最直观——既避免了因字段名太短而误触发，也减少了无意义的模型唤醒次数。
针对超大单文件启用流式分析模式
当项目中存在 >10MB 的日志、SQL 导出或生成代码文件时，CodeBuddy 默认会尝试全量加载，极易导致编辑器假死。此时需主动启用流式上下文机制。
- 按 Ctrl+, 打开设置，搜索
codebuddy.largeFileMode - 将其值设为 true
- 再搜索
codebuddy.contextWindowLines，建议设为 500（上限，兼顾精度与性能） - 重启工作区，编辑超大文件时将只加载光标前后 500 行，补全响应恢复流畅
该模式下不支持跨函数跳转，但关键词、变量名、缩进块级补全全部可用，兼顾可读性与效率。
