IntelliSense失效可按五步修复:一、重启TS服务;二、启用对应语言扩展;三、检查tsconfig.json/jsconfig.json配置;四、禁用冲突扩展;五、重置suggest相关设置。

如果您在VSCode中编写代码时发现IntelliSense无法提供变量、函数或模块的自动补全与类型提示,则可能是由于扩展配置异常、语言服务未启用或工作区设置冲突所致。以下是修复此问题的步骤:
本文运行环境:MacBook Air,macOS Sequoia。
一、重启JavaScript/TypeScript语言服务
VSCode的IntelliSense依赖内置的TypeScript语言服务提供核心智能提示能力。该服务可能因缓存错误或进程卡死而停止响应,重启可强制刷新服务状态并恢复功能。
1、按下 Cmd + Shift + P 打开命令面板。
2、输入 TypeScript: Restart TS server 并回车执行。
3、等待右下角通知显示 TypeScript language service restarted。
二、检查并启用对应语言扩展
IntelliSense功能由特定语言扩展提供支持,若相关扩展被禁用、未安装或版本过旧,将直接导致提示失效。需确认当前文件类型所依赖的扩展处于激活状态。
1、打开左侧活动栏中的 扩展(Extensions) 图标。
2、在搜索框中输入 @builtin typescript 或 @builtin javascript。
3、确保 TypeScript and JavaScript Language Features 显示为已启用(开关为蓝色)。
4、如为Python文件,搜索并启用 Pylance;如为C++文件,确认 C/C++ 扩展已启用且未被禁用。
三、验证工作区tsconfig.json或jsconfig.json配置
当项目根目录存在tsconfig.json或jsconfig.json时,VSCode会依据其内容决定如何解析模块路径与类型声明。若配置缺失、语法错误或exclude范围过宽,IntelliSense将无法正确索引源码。
1、在项目根目录查找是否存在 tsconfig.json 或 jsconfig.json 文件。
2、若不存在,可在终端中执行 tsc --init(需已安装TypeScript)生成默认tsconfig.json。
3、若文件存在,检查其中 "include" 字段是否覆盖当前编辑的源文件路径,例如:["src/**/*"]。
4、确认 "exclude" 未意外包含源码目录,如误写为 ["./src"]。
四、关闭其他干扰性扩展
部分第三方扩展(如老旧的TSLint、自定义语法高亮器或非官方语言服务器)可能劫持语言功能入口,与原生IntelliSense发生冲突,导致提示完全消失或仅部分生效。
1、按下 Cmd + Shift + P 打开命令面板。
2、输入并选择 Developer: Toggle Developer Tools,切换至Console标签页。
3、在编辑器中打开一个.ts文件,观察控制台是否出现类似 Failed to start language server 或 Extension X blocked language feature Y 的报错。
4、根据报错信息定位扩展名称,在扩展面板中将其 禁用,然后重新加载窗口(Cmd + Shift + P → Developer: Reload Window)。
五、重置用户设置中的IntelliSense相关选项
用户自定义设置可能覆盖默认的IntelliSense行为,例如禁用了建议弹窗、设定了错误的suggest模式或关闭了自动触发,导致提示不主动出现。
1、按下 Cmd + , 打开设置界面。
2、在搜索框中输入 editor.suggest。
3、确认以下三项均为启用状态:editor.suggest.enabled、editor.suggest.showKeywords、editor.suggest.showMethods。
4、搜索 editor.quickSuggestions,确保其值为 true 或对象形式中 strings、other、comments 均设为 true。










