CodeBuddy 编辑超大文件时补全迟缓或失效，可启用流式分析、调大上下文窗口、禁用跨文件补全、切换只读模式或分片启用补全。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 CodeBuddy 编辑超大文件（例如超过 10MB 的源码文件或日志转储文件）时发现代码补全响应迟缓、建议缺失或完全不触发，则可能是由于内存限制、上下文截断策略或语言服务负载过高所致。以下是应对该问题的多种处理方式：
一、启用流式上下文分析模式
CodeBuddy 默认对单文件启用完整语法树解析，但在超大文件中会自动切换为流式上下文分析，仅加载光标附近指定行数（默认±200行）的代码片段参与补全建模，避免全量加载导致 OOM 或卡顿。该模式由后台语言服务器自动启用，无需手动干预，但可通过配置强化其稳定性。
1、在 VS Code 中按 Ctrl + , 打开设置页面。
2、在搜索框输入 codebuddy.largeFileMode。
3、将值设为 true 并保存配置。
4、重启当前工作区以使设置生效。
二、调整上下文窗口大小
补全质量依赖于有效上下文长度。超大文件中若光标远离关键定义区域，模型可能无法捕获必要语义。通过显式扩大局部上下文窗口，可提升补全准确性，同时避免全局加载。
1、打开设置页面，搜索 codebuddy.contextWindowLines。
2、将数值从默认 200 调整为 500（最大推荐值，超出可能引发延迟）。
3、确认修改后，重新打开超大文件并定位至需补全位置。
三、禁用非关键补全增强项
CodeBuddy 的 Pro 补全能力（如跨文件变量追踪、函数引用预测）在超大文件中会显著增加计算开销。临时关闭这些高成本特性，可恢复基础补全响应速度。
1、点击 VS Code 窗口右下角状态栏中的 CodeBuddy 图标。
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 问题
2、在弹出菜单中选择 Disable Cross-File Completion。
3、勾选 Skip Semantic Analysis for Large Files 选项。
4、刷新编辑器标签页，观察补全触发是否恢复正常频率。
四、切换至只读+补全优化模式
对于仅需阅读与局部编辑的超大文件（如生成式代码日志、数据库导出脚本），启用只读优化模式可绕过语法校验与实时 AST 构建，专供轻量级补全服务。
1、右键编辑器标签页，选择 Open with CodeBuddy (Read-Only Mode)。
2、该模式下补全仅基于词法模式与最近 3 层缩进块进行匹配。
3、输入任意字母后，观察是否立即出现基础符号补全（如已定义变量、关键字）。
五、分片加载与区域限定补全
当文件过大导致语言服务拒绝加载时，CodeBuddy 支持人工划分逻辑区域，仅对选定代码块启用补全。此方法适用于超长配置文件或模板化代码段。
1、用鼠标拖选目标代码段（建议不超过 500 行）。
2、右键选区，选择 Enable Context-Aware Completion in Selection。
3、在选区内任意位置输入，补全将仅依据该区域内容生成建议。
4、完成补全后，可取消选区继续浏览全文，补全服务将自动暂停。
