codebuddy索引缓慢的四大优化方案：一、在settings.json中配置excludepatterns排除node_modules等无关目录并重启服务；二、启用incremental索引模式并执行codebuddy clean-index清理旧缓存；三、在monorepo中配置ts composite及references提升跨包感知；四、关闭isolation mode以打通全局上下文。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeBuddy在大型项目中索引构建缓慢、反复卡在“正在编制索引”状态，导致代码补全延迟、跳转失效、语义搜索无响应，根本原因是索引范围过大或上下文分析路径未收敛。
限制索引扫描范围
默认情况下，CodeBuddy会递归扫描整个工作区目录，包括node_modules、dist、build等非源码区域，这些文件体积庞大且语义无关，直接拖垮索引构建速度。
第一步：按下 Ctrl + Shift + P（Windows/Linux）或 Cmd + Shift + P（macOS），输入并选择「Preferences: Open Settings (JSON)」。
第二步：在打开的settings.json文件末尾添加以下配置项：
"codebuddy.context.excludePatterns": ["**/node_modules/**", "**/dist/**", "**/build/**", "**/out/**", "**/*.log", "**/coverage/**"]
第三步：保存文件后，右键点击CodeBuddy状态栏图标 → 选择「Restart CodeBuddy Service」。这一步必须执行，否则新配置不会生效。【不重启服务，排除规则形同虚设】
启用增量索引模式
全量重建索引动辄耗时数分钟甚至十几分钟，而日常开发中仅修改少量文件。开启增量索引后，CodeBuddy只对变更文件及其依赖链重新分析，构建耗时下降70%以上。
方法一：通过命令面板快速启用
按下 Ctrl + Shift + P → 输入「CodeBuddy: Toggle Incremental Indexing」→ 回车启用。状态栏将显示「Incremental indexing: ON」。
方法二：手动配置强制生效
在 settings.json 中追加配置："codebuddy.indexing.mode": "incremental"
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 clean-index，再重启服务。
绑定TS项目引用提升跨包感知效率
monorepo或多包项目中，TypeScript原生的项目引用机制能为CodeBuddy提供精准的依赖拓扑，避免重复解析和无效遍历，显著缩短上下文构建时间。
① 打开每个子包下的tsconfig.json，确认已包含：
"composite": true,
② 在根目录tsconfig.json中，添加references字段：
"references": [
{"path": "./packages/ui/tsconfig.json"},
{"path": "./packages/utils/tsconfig.json"},
{"path": "./packages/api/tsconfig.json"}
]
③ 保存全部tsconfig文件后，在VS Code中右键任意tsconfig → 选择「Reload Project」。CodeBuddy将自动识别复合项目结构并启用增量式跨包类型推导。
这一步操作起来很简单，直接把tsconfig改完保存就行，但漏掉任一子包的composite设置，整个引用链就会断裂，导致索引退化为单包模式。
关闭隔离沙箱释放上下文连通性
CodeBuddy默认启用Isolation Mode，将各文件视为独立单元处理，虽增强安全性，却切断了跨文件、跨目录的语义关联，迫使每次补全都重新加载局部上下文，拖慢响应。
进入CodeBuddy设置面板 → 找到「Advanced」选项卡 → 将「Isolation Mode」开关设为Off → 点击「Apply & Restart」。
重启后，状态栏提示变为「Context merged across workspace」，此时跨文件跳转、全局符号搜索、多包补全将同步提速。
