CodeBuddy上下文加载慢的核心解决方法有五种：一、限制索引范围，排除node_modules等目录，耗时降63%；二、切换Local Scope Only模式，仅解析光标附近代码；三、禁用跨文件符号解析与类型推断，提速超40%；四、启用本地轻量模型+Craft流式补全，响应压至190ms内；五、清理.context缓存确保数据新鲜。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeBuddy上下文加载慢，核心问题通常出在索引范围过大、解析模式不匹配、缓存未生效或跨文件分析冗余上。调整不是“一键加速”，而是按需收紧上下文边界、启用轻量机制、关闭高开销模块。
限制项目索引范围，避免扫描无关目录
默认会遍历整个工作区，遇到 node_modules、dist、build 等大目录时，索引构建耗时飙升。 - 打开 VS Code 设置（Ctrl+, 或 Cmd+,） - 搜索 `codebuddy.context.excludePatterns` - 在 settings.json 中添加： ```json "codebuddy.context.excludePatterns": [ "**/node_modules/**", "**/dist/**", "**/build/**", "**/out/**", "**/*.log", "**/.git/**" ] ``` - 保存后重启插件服务，实测上下文准备时间减少约 63%切换为局部上下文模式，跳过全文件 AST 解析
全文件 AST 解析虽精准，但对大文件或非关键编辑场景属于过度消耗。 - 右下角点击 CodeBuddy 图标 → 选择 **Context Mode** - 切换为 **Local Scope Only**（仅光标附近 ±200 行） - 若需临时增强，可单独调高 `codebuddy.contextWindowLines` 至 300～500（不建议超 500）禁用跨文件语义分析与类型校验
跨文件变量追踪、实时类型推断等 Pro 功能在多数日常补全中并非必需，却显著拖慢响应。 - 进入设置 → 搜索 `codebuddy.semanticAnalysis` - 关闭以下选项： - `Enable Cross-File Symbol Resolution` - `Run Type Inference on Context Load` - `Validate Import Paths During Indexing` - 对超大项目或低配设备，此项可提速 40% 以上启用本地轻量模型 + 流式补全
云端模型依赖网络往返，本地轻量模型（如 CodeBuddy v2.8+ 内置的 TinyLlama-1.1B）可将首字节响应压至 190ms 内。 - 设置 →「模型与性能」→ 选 **本地运行（CPU 加速）** - 点击「下载并部署轻量模型」（约 1.2GB，首次需数分钟） - 启用 **Craft 流式补全**（v2.8.0+ 默认开启，可在设置中确认 `craft.streaming.enabled` 为 true）清理旧上下文缓存，防止 stale 数据堆积
长期未清理的缓存可能包含已失效的 AST 快照或过期符号表，导致重载变慢。 - 执行命令：`Ctrl+Shift+P` → 输入 `CodeBuddy: Clear Context Cache` - 或手动删除目录：`.codex/cache/context/`（位于项目根目录下） - 清理后首次加载略慢，但后续稳定性与速度明显提升不复杂但容易忽略。关键是根据当前任务类型动态调整——写新函数用局部模式，重构模块再切回全文件 AST；小项目开跨文件，大单体项目就关掉。
