VSCode默认不自动导入组件，根本原因是语言服务未识别项目结构或关键开关未开启；需确认右下角语言模式正确、存在tsconfig.json/jsconfig.json、重启TS/Python服务器、启用javascript.suggest.autoImports和typescript.suggest.autoImports为true，并正确配置tsconfig.json的baseUrl/paths。
VSCode 默认不自动导入组件，不是功能缺失，而是语言服务没识别到项目结构或关键开关没打开——90% 的“不提示”问题都卡在这几个硬性条件上。
检查右下角语言模式和 TS/JS 服务是否就绪
这是所有自动导入的前提。如果状态栏显示 Plain Text、HTML 或 Vue (Deprecated)，那补全逻辑压根没启动。
- 点击右下角语言标识（如
Vue、TypeScript React），确保它匹配当前文件：.vue 文件要切到Vue (Volar)，.tsx 要是TypeScript React，不是纯TypeScript - 项目根目录必须有
tsconfig.json（TS）或jsconfig.json（JS），哪怕内容只是{"compilerOptions": {}} - 按
Ctrl+Shift+P→ 输入Restart TS server并执行；Python 用户则运行Python: Restart Language Server - 打开开发者工具（
Ctrl+Shift+P→Developer: Toggle Developer Tools），在 Console 里输入require('typescript')，不报错才算加载成功
开启 autoImports 设置（必须显式设为 true）
这个布尔值默认是 false，新装 VSCode 或重置设置后极易遗漏。它控制的是「输入时是否在补全列表中显示带 import 前缀的选项」。
- 打开设置（
Ctrl+,），搜索autoImports，把JavaScript > Suggest: Auto Imports和TypeScript > Suggest: Auto Imports都勾上 - 或者直接编辑
settings.json，加入这两行（注意拼写是autoImports，不是autoImport，且true不加引号）："javascript.suggest.autoImports": true,<br>"typescript.suggest.autoImports": true
- 别和
editor.codeActionsOnSave混淆：后者管保存时整理 import，前者才是补全时插入的关键
路径别名（如 @/components）要靠 tsconfig.json 声明
VSCode 完全不读 Webpack/Vite 的 resolve.alias，只认 tsconfig.json 里的 baseUrl 和 paths。
- 在
tsconfig.json的compilerOptions中配置："baseUrl": "./",<br>"paths": {<br> "@/*": ["src/*"],<br> "@components/*": ["src/components/*"]<br>} - 改完必须重启 TS Server（
Ctrl+Shift+P→Restart TS server） - 确认
include字段覆盖了实际路径，比如"include": ["src/**/*", "src/components.d.ts"]，漏掉tests/或pages/就解析不了 - 多根工作区下，只有「活动文件夹」的配置生效，其他子项目需单独配
tsconfig.json或用"extends"继承
Vue 单文件中 template 里不提示？重点查 Volar 和类型声明
<template></template> 里写 <mybutton></mybutton> 却没导入建议，根本原因不是插件没装，而是 Volar 没拿到组件类型信息。
- 确保已安装
Volar（不是 Vue Official），且 .vue 文件语言模式是Vue (Volar) - 若用了
unplugin-vue-components，必须配置dts: 'src/components.d.ts'，并把该路径加进tsconfig.json的include - 生成的
components.d.ts必须包含类似declare module 'vue' { interface GlobalComponents { MyButton: typeof import('./components/MyButton.vue') } }的声明 - 改完 vite.config.ts 后务必重启 TS Server；同时检查
typescript.preferences.experimental.enableAutoImport是否为true -
<template></template>里不生效是正常的——自动导入只在<script></script>区域内触发；<template></template>中的组件使用依赖 Volar 的类型推导，不是 import 补全
最稳的触发方式不是等输完回车，而是把光标停在未定义的符号上（比如刚打完 useEffect），按 Ctrl+.（Windows/Linux）或 Cmd+.（macOS）调出 Quick Fix。如果这一步都没反应，说明前面四步至少有一处没到位——尤其是 tsconfig.json 存在与否、autoImports 是否为布尔 true、以及右下角语言模式是否正确。
