VSCode补全推荐错变量是因为默认采用混合加权排序而非纯前缀匹配，受局部性、词频、大小写及子字符串匹配影响；可通过启用matchOnWordStartOnly、关闭localityBonus等配置逼近严格前缀匹配，但语言服务器（如Pylance/TS）的补全逻辑不受此控制。
补全列表为什么总推荐错的变量？
VSCode 默认的补全匹配算法不是纯前缀匹配，而是混合了子字符串、大小写敏感度、词频和局部性（locality）的加权排序。你输入 user 却看到 username、isUserValid、UserService 全部排在前面，往往是因为这些符号在当前文件或最近作用域中出现过，被 editor.suggest.localityBonus 拉高了权重。
常见错误现象包括：刚定义的变量没出现在首项、驼峰命名断开后不触发、同名但不同作用域的符号混在一起干扰选择。
-
editor.suggest.localityBonus: true（默认开启）会让当前文件/作用域内的符号优先，关掉可让全局符号更公平参与排序 -
editor.suggest.filterSort: "score"（默认）按综合得分排序；设为"none"可禁用智能排序，仅按字母序显示，便于排查干扰项 - 驼峰匹配依赖
editor.wordSeparators配置，若你自定义了分隔符（比如加了/或-），可能破坏userName→user的拆分逻辑
如何让补全严格按前缀匹配？
如果你明确只想看到以输入文本开头的项（例如输 get 就只列 getUser、getCount，不列 aggregate 或 permission），需关闭子串匹配行为。
VSCode 没有直接开关叫“strict prefix mode”，但可通过组合配置逼近效果：
- 设置
"editor.suggest.matchOnWordStartOnly": true—— 强制只匹配单词开头，这是最接近前缀匹配的选项 - 同时关闭
"editor.suggest.showWords": false（隐藏纯单词补全，避免干扰） - 禁用 locality bonus：
"editor.suggest.localityBonus": false，防止局部变量抢权重 - 注意：该配置对语言服务器（如 Pylance、CSS Language Server）提供的补全项影响有限，它们内部仍可能做自己的匹配；真正生效的是 VSCode 自身的符号索引补全（如变量名、函数名）
Pylance / TypeScript 补全为何不听 settings.json？
Python 或 TS 的补全建议主要由对应语言服务器生成并排序，VSCode 的 editor.suggest.* 设置只控制最终渲染层的过滤与展示顺序，不干预语言服务器内部的候选生成逻辑。
这意味着：即使你开了 matchOnWordStartOnly，Pylance 仍可能把 asyncUserFetch 推上来，只要它判定这个方法“最符合当前上下文类型”。
- 真正能约束 Pylance 行为的是
python.analysis.typeCheckingMode和python.analysis.autoImportCompletions等专属设置 - TS/JS 用户应关注
typescript.preferences.includePackageJsonAutoImports和javascript.suggest.autoImports，它们决定是否把远端模块名也纳入前缀匹配范围 - 验证方式：打开命令面板（
Ctrl+Shift+P），运行Developer: Toggle Developer Tools，在 Console 中输入vscode.workspace.getConfiguration('editor').get('suggest')，确认实际加载值
补全慢或卡顿时，匹配算法是背锅侠吗？
匹配算法本身开销极小，真正拖慢补全响应的通常是语言服务器未就绪、AST 解析卡住、或补全项过多导致渲染压力大。
一个常被忽略的点：当项目里有大量未 resolve 的导入（比如 import { X } from 'some-missing-package'），Pylance 或 TS Server 会反复尝试解析路径，期间所有补全请求都会排队等待——看起来像“匹配太慢”，实则是服务阻塞。
- 检查状态栏右下角：若有黄色警告图标或“Loading…”提示，说明语言服务器未 ready
- 临时禁用
editor.suggest.snippetsPreventQuickSuggestions可释放部分渲染压力（尤其在输入if、for等关键词时） - 大型 monorepo 中，
files.exclude和search.exclude漏配会导致语言服务器扫描无关目录，间接拉长匹配前的准备时间
匹配算法的配置项只是最后一步的“筛子”，别在它身上浪费太多调试时间——先确认语言服务器健康、路径配置干净、缓存未腐坏，再调参。
