IntelliSense 失效主因是语言模式错误、配置缺失或服务异常;需检查右下角语言标识、配置 jsconfig.json/tsconfig.json、重启对应语言服务器,并通过日志定位深层问题。

IntelliSense 不工作,90% 的情况不是插件坏了,而是 VSCode 没“认出你在写什么”——语言模式错、服务没起来、配置被覆盖,或缓存卡住了。
右下角显示 Plain Text 或 Unknown 怎么办
这是最常见信号:VSCode 根本没加载对应语言服务器,补全、跳转、类型提示全部失效。
- 点击右下角语言标识(如
Plain Text),手动选对语言,.ts文件必须选TypeScript,不是JavaScript (Legacy);.py文件优先选Python (Pylance),别留着Python (Jedi) - 用命令面板(
Ctrl+Shift+P)运行Change Language Mode,输入语言名快速切换——比点右下角更可靠,尤其在文件关联被覆盖时 - 检查
settings.json里有没有误配的"files.associations",比如把"*.vue"映射成"html",结果script块里的 TS 代码就彻底失智
TypeScript/JS 项目补全弱、跳不到 node_modules 怎么办
没有 jsconfig.json(JS 项目)或 tsconfig.json(TS 项目),IntelliSense 就只能做基础语法提示,模块解析、路径别名、第三方库类型统统不认。
- 在项目根目录新建
jsconfig.json,至少包含:{ "compilerOptions": { "baseUrl": ".", "paths": { "@/*": ["src/*"] } }, "include": ["src/**/*"], "exclude": ["node_modules"] } - 确保文件保存后等几秒——状态栏会短暂显示
Initializing JS language features,完成后才生效 - monorepo 项目必须把
tsconfig.json放在真正的工作区根目录,而不是某个packages/foo子目录里;否则tsserver找不到入口,整个项目降级为“无配置模式”
重启语言服务器没反应,CPU 却跑满怎么办
语言服务(如 tsserver、Pylance)可能卡死、内存泄漏或启动失败,界面毫无提示,但补全就是不动。
- 先试
Developer: Reload Window—— 解决 80% 的临时卡顿 - 再针对性执行:
TypeScript: Restart TS Server(JS/TS)、Python: Restart Language Server(Python) - Windows 用户打开任务管理器,杀掉残留的
node.exe进程(特别是多个tsserver实例占满 CPU 时) - Mac/Linux 可终端执行:
pkill -f tsserver或pkill -f pylance
禁用所有扩展后恢复,但不想一个个试怎么办
冲突常来自 Prettier、Auto Rename Tag、老旧的 Path Intellisense,它们会劫持补全链路,优先级高于默认语言服务。
- 别急着卸载,先开开发者工具(
Ctrl+Shift+P→Developer: Toggle Developer Tools),切到Console标签,看有没有Failed to start language server或Cannot read property 'map' of undefined - 对 TypeScript/JS:设
"typescript.tsserver.log": "verbose",重启后去输出面板 →TypeScript Server Log查线索 - 对 Python:设
"python.analysis.logLevel": "Trace",输出面板 →Python Language Server里找ENOENT或Failed to load project
真正难搞的往往不是“不会配”,而是日志里那一行 Cannot resolve module 'xxx' 背后,其实是 jsconfig.json 的 baseUrl 指错了位置,或者 files.associations 把 .d.ts 文件映射成了 plaintext —— 这些细节不翻日志根本看不到。


















