代码补全突然失灵，先别急着怪 VSCode。 十次有九次，是语言服务没连上、配置被改了，或者缓存堵住了。

通常只要花三分钟排查，基本就能找到原因。先看右下角状态栏，这里往往就有第一手线索。

右下角显示 Plain Text 或 Unknown 怎么办

别小看右下角那个标签。要是它显示 Plain Text 或 Unknown，基本等于语言服务没被正确触发。

VSCode 不知道你写的是哪种语言，自然不会启动对应的语言服务器，IntelliSense 也就不会出现。

解决方法很直接：点击这个标签，手动切换成正确的语言模式，比如 Ja vaScript、TypeScript、Python 或 Vue。

同时还要确认文件后缀是否匹配。比如 utils.js 如果被误识别成 TypeScript，很可能是 files.associations 里有人写了 "*.js": "typescript"。

这种情况下，类型校验可能会混乱，补全能力也会跟着降级。

还有一个常被忽略的细节：未保存的临时文件，比如 Untitled-1，默认就是 Plain Text，不会触发任何语言服务。

先把文件保存成 .py 或 .ts，再试一次，补全功能可能就恢复了。

editor.quickSuggestions 和 editor.tabCompletion 没开

补全窗口不弹出，或者 Tab 键只能缩进，常见原因就是这两个开关没开。

它们分别是 editor.quickSuggestions 和 editor.tabCompletion。在部分语言里，这两个选项默认就是关闭的，这不是 bug，而是设计如此。

打开设置（Ctrl + ,），搜索 quick suggestions，确认 editor.quickSuggestions 下的以下三项都设成 true：

• other
• strings
• comments

然后再搜索 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

项目级配置缺失导致索引退化

语言服务再聪明，也需要“项目说明书”。如果缺少关键项目配置，它就只能盯着当前文件，无法完整推断模块路径、别名和类型声明。

这时候，补全功能通常就会变得不完整，甚至明显退化。

TypeScript/Ja vaScript 项目，必须有一个 tsconfig.json 或 jsconfig.json。

哪怕文件里只写一个 {}，也比没有强。否则 tsserver 默认不解析 node_modules，也不会处理 @/ 这种路径别名。

Python 项目则要确认 python.defaultInterpreterPath 指向的是真实虚拟环境路径，比如 ./venv/bin/python，而不是系统自带的 /usr/bin/python3。

CSS 类名提示也依赖配置。如果你使用的是 .pcss 或 .module.css，需要在 css.fileExtensions 里显式声明：

"css.fileExtensions": ["css","scss","less","pcss","module.css"]

Vue 3 项目如果使用 Volar，还要记得关闭旧版 Vetur 的干扰："vetur.validation.template": false。

排查时不要只盯一个点

真正让补全“彻底失灵”的，往往不是单一问题，而是多个环节同时出错。

比如语言模式不对、缓存卡住、扩展冲突、项目配置缺失，这些问题叠加后，表面上看起来就像补全完全坏了。

更高效的做法，不是反复重装插件，而是按顺序排查：

• 先看右下角语言模式
• 再查 settings.json
• 接着看输出面板日志
• 最后检查项目根目录配置文件

按这个顺序扫一遍，通常比盲目折腾插件更快找到病根。