VSCode自动导入依赖语言服务激活、正确语言模式识别及配置文件存在;需确保状态栏显示TS/JS/Python、启用typescript.suggest.autoImports等设置、项目含tsconfig.json/jsconfig.json,并用Ctrl+.触发快速修复。

VSCode 默认不自动插入 import 语句,不是插件没装,而是语言服务没激活、配置缺失或语言模式识别错误——绝大多数“不提示导入”的问题都卡在这三步上。
检查右下角语言模式和语言服务器是否就绪
这是所有自动导入功能的前提。VSCode 的自动导入完全依赖语言服务器(TypeScript Server、Pylance 等),不是靠插件“硬补”。
- 右下角状态栏必须显示
TypeScript、JavaScript或Python,且旁边有齿轮图标;若显示Plain Text、HTML或Vue (Deprecated),说明语言模式错误 - Vue 单文件需点击右下角切换为
vue模式,并确保已安装Volar(非 Vue Official) - 打开命令面板(
Ctrl+Shift+P),运行Developer: Toggle Developer Tools,在 Console 中输入require('typescript')—— 若报Cannot find module 'typescript',说明 TS 服务未加载
确认项目配置文件和关键设置已启用
没有 tsconfig.json 或 jsconfig.json,语言服务无法解析模块路径,自动导入就形同虚设。
- 在项目根目录创建空的
tsconfig.json(内容只需{"compilerOptions": {}})或jsconfig.json(加"checkJs": true) - 打开
settings.json(Ctrl+,→ 右上角“打开设置(JSON)”),确保包含以下两行(注意是布尔值true,不是字符串"true"):"typescript.suggest.autoImports": true"javascript.suggest.autoImports": true - Python 用户还需确认:
"python.languageServer": "Pylance""python.analysis.autoImportCompletions": true"editor.quickSuggestions.other": true
用对快捷键:Ctrl+. 是最可靠触发方式
别等输完回车——那大概率只插入名字,不加 import。真正稳定的是手动唤起 Quick Fix。
- 光标放在带红色波浪线的未定义标识符上(如
useState、Path、np),按Ctrl+.(Windows/Linux)或Cmd+.(Mac) - 弹出菜单中选 “Import ‘useState’ from ‘react’” 或类似选项,即自动生成
import行 - 该快捷键只在编辑器文本焦点内生效(
when: "editorTextFocus && !editorReadonly"),终端、设置页里无效 - 若无反应,先运行命令
TypeScript: Restart TS server或Python: Restart Language Server
路径别名(如 @/hooks)导入失败?VSCode 只认 tsconfig.json
VSCode 完全不读 Webpack/Vite 的 resolve.alias,它只认 tsconfig.json 或 jsconfig.json 里的 baseUrl 和 paths。
- 在
tsconfig.json的compilerOptions中配置:"baseUrl": ".","paths": { "@/*": ["src/*"] } - 配置后必须重启 TypeScript Server(命令面板搜
Restart TS server),否则别名不会被识别 - Auto Import 插件(steoates 版)能更好支持别名路径,但前提是语言服务本身已正确加载这些配置
最容易被忽略的是:语言服务是否真正在运行。状态栏没显示正确语言模式、控制台报 Cannot find global type 'Array'、右下角一直显示“分析中…”——这些都不是配置没写对,而是服务根本没起来。先解决这个,再调设置。











