VSCode补全卡顿主因是无效文件扫描与自动导入膨胀，禁用autoImports、限制TS作用域、排除node_modules监听、关闭TS日志及Pylance冗余分析可显著提速。
VSCode自动补全卡顿、CPU飙升，核心问题往往不在语言服务器本身，而是补全请求被频繁触发、上下文无节制膨胀、或插件在后台持续扫描——关掉几个默认开关，比换硬件更有效。
禁用自动导入与智能包补全
JavaScript/TypeScript 的 javascript.suggest.autoImports 和 typescript.preferences.includePackageJsonAutoImports 是内存与 CPU 的隐形大户。它们会在每次输入时主动解析 node_modules 中所有导出项，生成补全候选，尤其在大型依赖（如 @types/react + lodash + date-fns）共存时极易拖慢响应。
- 在
settings.json中设为false：
{
"javascript.suggest.autoImports": false,
"typescript.preferences.includePackageJsonAutoImports": "off"
}
- 需要导入时，用
Ctrl+Space手动唤出补全，再按Tab或Enter插入；或使用Ctrl+Shift+O（Go to Symbol in File）快速跳转后手动 import - 不建议全局关闭
typescript.suggest.enabled，它会同时禁用函数签名、参数提示等关键功能
限制 TypeScript/JS 语言服务作用域
默认情况下，TS 语言服务器会尝试索引整个工作区，包括 node_modules、dist、测试文件等非编辑目标路径。这不仅拉高内存，还会让补全候选列表混入大量无关项，降低准确率。
- 在
tsconfig.json中明确"include"范围，例如只包含源码目录：
{
"include": ["src/**/*"],
"exclude": ["node_modules", "dist", "tests"]
}
- 配合 VSCode 设置
"typescript.preferences.useAliasesForRenames": false，避免重命名时遍历所有引用路径 - 关闭 TS 日志：
"typescript.tsserver.log": "off"，减少磁盘 I/O 和日志缓冲区占用
关闭文件监视对补全的干扰
VSCode 的补全行为常被 files.watcherExclude 配置间接影响——如果监听器卡在 node_modules 或 .git 目录上，会导致语言服务无法及时响应编辑事件，表现为“敲完字母等 1–2 秒才出提示”。
- 必须添加到
.vscode/settings.json：
{
"files.watcherExclude": {
"**/node_modules/**": true,
"**/.git/objects/**": true,
"**/dist/**": true,
"**/build/**": true
}
}
- Linux/macOS 用户可额外加
"**/tmp/**": true，避免临时文件触发重建缓存 - 注意：该设置需重启窗口（
Developer: Reload Window）才生效，仅保存 settings 不够
Python / Pylance 场景下特别处理
Python 开发者容易忽略的是，Pylance 默认启用 python.analysis.extraPaths 和递归 __init__.py 解析，一旦项目含多个子包或符号链接，补全延迟会指数级上升。
- 禁用自动路径发现：
"python.analysis.extraPaths": [] - 关闭符号链接跟随：
"search.followSymlinks": false（防止跨目录重复索引） - 对超大项目，强制使用基于 AST 的轻量模式：
"python.analysis.typeCheckingMode": "basic"，跳过严格类型推导阶段 - 若用 Poetry 或 Pipenv，确保
python.defaultInterpreterPath指向虚拟环境内解释器，避免 Pylance 错误加载系统 site-packages
真正卡住补全的，从来不是“要不要提示”，而是“提示前要扫多少文件、查多少包、建多少 AST”。每一条排除规则、每一个 false 开关，都是在把语言服务从无效路径上拽回来。别信“等它缓存完就好”——缓存本身就在吃内存。
