很多开发者在实际开发中都会遇到这样的困扰——当项目代码量突破上万行时，CodeBuddy 的响应速度会明显下降。补全建议弹出缓慢、右键菜单里的“Ask CodeBuddy”迟迟没有反应、鼠标悬停提示延迟超过两秒，严重时甚至直接导致 IDE 主线程卡死。这并非网络波动或模型超时所致，问题的根源在于静态分析模块——它正在全量索引阶段疯狂抢占 CPU 和内存资源。

要彻底解决这个长期困扰开发者的性能顽疾，其实只需要三个关键步骤。

关闭非必要静态分析模块

CodeBuddy 默认开启了三项深度静态分析能力：跨文件符号推导、实时类型校验、未使用变量标记。这些功能在小型项目中表现贴心，但一旦面对万行级的代码库，它们就会持续扫描整个工作区的 AST（抽象语法树）并维护庞大的符号表——你每敲一个字，它就要遍历整个项目。补全响应时间直接翻倍。该怎么办？关闭其中两项，优化效果立竿见影。

方法一：在设置面板中一键完成配置。
打开 CodeBuddy 设置面板，进入「分析行为」子页面，找到「启用跨文件符号推导」和「实时类型校验」这两项，取消勾选即可。保存后无需重启，三秒内就能感受到明显的性能改善。

方法二：手动编辑 settings.json，这种方式更彻底，也更适合需要精细控制配置项的进阶用户。
按下 Ctrl + Shift + P，输入并选择「Preferences: Open Settings (JSON)」，在文件末尾追加以下两行配置：

"codebuddy.analysis.crossFile": false,
"codebuddy.analysis.typeInference": false

有一点需要特别提醒：请务必保留文件中已有的其他 codebuddy.* 配置项，否则补全模型路径等关键设置可能会被意外重置。

限制静态分析作用域范围

即便关闭了那两个高开销的分析模块，CodeBuddy 仍然会默认对项目中的所有 .ts、.js、.py 文件执行基础语法树构建和词法索引。这一步本身，在万行级项目中就要消耗数百 MB 内存，并且拖慢首次加载速度。换句话说，你必须显式地告诉它哪些目录不需要分析，否则前面的优化优化等于白做。

第一步：在项目根目录下新建一个纯文本文件，命名为 .codebuddyignore。注意编码必须使用 UTF-8，且不能带有 BOM 头。

第二步：写入四类典型的排除路径。每一行使用一个模式，大小写敏感：

node_modules/**
dist/**
build/**
**/__tests__/**

第三步：强制刷新索引缓存。点击 VS Code 窗口右下角的 CodeBuddy 图标，选择「Rebuild Index for Current Workspace」。等待状态栏显示「Index rebuilt (12 files scanned)」而不是「(3421 files scanned)」，就说明排除规则已生效。

切换至轻量补全模式

当项目规模突破 8000 行，并且没有跨模块的强依赖时，语义级补全带来的收益其实远低于它消耗的系统开销。这时，主动降级为词法加缩进感知的模式，响应时间可以从平均 1.2 秒直接压缩到 180 毫秒以内——体验提升非常明显。

操作也很简单：进入 CodeBuddy 设置，找到「模型与性能」页面，将「补全模式」下拉菜单从「Semantic + Contextual」改为「Lexical + Indentation Only」，然后勾选「跳过函数签名解析」，最后点击「Apply & Restart Language Server」。

这一步会彻底禁用所有基于 AST 的参数提示、返回值推断、重载识别等功能，但变量名、关键字、import 导入项这些高频补全内容依然保留。对于 CRUD 类的业务代码来说，实际编码效率几乎不受影响，而响应速度的提升却是实实在在、立竿见影的。