VSCode代码自动补全失效排查_从插件缓存到设置项检查

补全失效并非软件损坏，而是语言服务未连接、配置被覆盖或缓存异常；90%的问题可在三分钟内定位，首要检查右下角语言模式是否为Plain Text或Unknown。

补全失效不是“坏了”，而是语言服务没连上、配置被盖住、或缓存卡在半路——先别重装，90% 的问题三分钟内可定位。

右下角语言模式显示 Plain Text 或 Unknown

这是最常见也最容易被忽略的起点。VSCode不知道你在写什么语言，就不会启动对应的语言服务器，IntelliSense根本不会加载。很多时候，问题就出在这个小细节上——右边状态栏里那个小小的语言标签，往往就是整个排查的突破口。

• 点击右下角状态栏中显示的 Plain Text 或 Unknown，手动选成 Ja vaScript、TypeScript、Python、HTML 等正确语言模式
• 检查文件后缀是否匹配：比如 utils.js 被识别为 TypeScript，可能因 files.associations 里写了 "*.js": "typescript"，这会导致类型校验错乱、补全降级
• 临时新建一个 test.py 文件，保存后再试补全；未保存的临时文件（如 Untitled-1）默认是 Plain Text，不触发任何语言服务

editor.quickSuggestions 和 editor.tabCompletion 没开

这两个设置控制补全“弹不弹”和“Tab键管不管用”，它们默认在部分语言里是关闭的，不是bug，而是设计如此。但很多人被这个“设计”坑过无数次。

• 打开设置（Ctrl + ,），搜 quick suggestions，确保 editor.quickSuggestions 在 other、strings、comments 三项都设为 true
• 搜 tabCompletion，把 editor.tabCompletion 设为 "onlySnippets"（推荐）或 "on"；设成 "off" 时，Tab 只缩进，不触发补全
• 注意：这些开关在 UI 设置界面改，只影响当前工作区；要全局生效，得确认 settings.json 里有对应项，且没被 workspace 配置覆盖

Pylance / TypeScript Server / Intelephense 卡死或没加载

补全建议空白、悬停无类型、跳转定义失效，大概率是语言服务器进程挂了、没启动、或加载失败——日志里才有真相。别盲目调设置，先看日志，往往能省下大量时间。

• 命令面板（Ctrl + Shift + P）运行 Developer: Restart Language Server，对 Python 是重启 Pylance，对 TS/JS 是重启 tsserver
• 设 "python.analysis.logLevel": "Trace" 或 "typescript.tsserver.log": "verbose"，然后看「输出」面板 → 选 Python Language Server 或 TypeScript Server Log
• 常见日志线索：Failed to load project（tsconfig.json 路径错）、ENOENT: no such file（工作区根路径识别错误）、Cannot read property 'map' of undefined（插件版本不兼容）
• Windows 用户可任务管理器杀掉残留的 node.exe 进程；macOS/Linux 可执行 pkill -f tsserver 或 pkill -f pylance

插件冲突与 AI 补全劫持 Tab 键

多个 AI 插件（Copilot、通义灵码、Tabnine）或格式化工具（Prettier、ESLint）同时启用时，常会互相覆盖补全来源，甚至抢走 Tab 的键盘事件。这种情况在多人协作或频繁切换工具链时尤其常见。

• 禁用所有第三方扩展，只留官方语言包（如 ms-python.python、ms-vscode.vscode-typescript-next），测试是否恢复
• 若恢复，逐个启用插件，观察补全何时变弱或消失；重点关注名字含 Copilot、AI、Code Assistant 的插件
• Tab 键按了没反应？检查是否有插件绑定了 tab 快捷键：打开键盘快捷键（Ctrl+K Ctrl+S），搜 tab，看哪些命令占用了它
• Emmet 缩写（如 div.container）不展开，可能是 emmet.triggerExpansionOnTab 关了，或当前语言 ID 不在 Emmet 默认支持列表里（如 .md 文件需配 "emmet.includeLanguages": {"markdown": "html"}）

真正难排查的，往往不是某个开关没开，而是多个配置叠加后产生的隐性压制——比如 files.associations 改了语言映射，又开了 emmet.includeLanguages，再加一个 AI 插件监听 textDocument/didChange，结果补全提示一会来自 Pylance，一会来自 Copilot，一会又没了。这种时候，日志和最小化复现比反复调设置更有效。