vscode自动导入失败的根本原因是语言服务未识别项目结构，需确保状态栏显示volar、根目录存在tsconfig.json（含types配置）、禁用vetur、开启autoimports设置并重启ts server。
VSCode 默认的 Ctrl+F 是字符串匹配，搜 login 找不到 authenticateUser；自动导入 Vue 组件失败，90% 不是插件没装，而是语言服务压根没识别到 .vue 文件——这两件事本质都是“语义断连”：编辑器不知道你写的词和项目里的东西有啥关系。
为什么 Ctrl+Shift+P 搜 “Vue Language Server” 才是第一步
Vue 单文件组件（.vue）的自动导入、模板中属性补全、definePageMeta 的 layout 提示，全部依赖 Volar 提供的类型系统。Vetur 已被官方弃用，两者共存会直接禁用语言服务。
- 状态栏右下角必须显示
Volar（不是Vue或Plain Text），且无感叹号 - 打开命令面板，运行
Developer: Toggle Developer Tools，Console 里出现Cannot find global type 'Ref'→ 说明tsconfig.json缺失或路径错误 - 确保项目根目录有
tsconfig.json，内容至少含：{"compilerOptions": {"types": ["#app"]}} - 禁用 Vetur：扩展面板里搜索
Vetur，点击“禁用”，重启 VSCode 窗口
npm 包自动导入不生效？检查 jsconfig.json 的 include 范围
VSCode 不会默认扫描 node_modules 里的类型定义，lodash、axios 这类包的函数名提示要靠显式声明路径范围。
递归分析 Vue 项目组件依赖，从入口文件生成组件层级图，支持 Vue 2/3，输出组件名、文件路径和属性。适用于分析组件结构、排查依赖或了解项目架构。
- 在项目根目录新建
jsconfig.json（Vue/JS 项目用这个，TS 项目优先用tsconfig.json） -
"include"必须覆盖你要导入的模块路径，例如：{"include": ["./src/**/*", "node_modules/axios/index.d.ts"]} - 如果只写
"include": ["./src/**/*"]，即使装了@types/axios，输入axios.get也不会触发 import 建议 - 改完
jsconfig.json后，必须运行TypeScript: Restart TS server（或Python: Restart Language Server）才生效
保存时自动组织 import 失效？别漏掉 codeActionsOnSave 的嵌套结构
"source.organizeImports" 不是开关按钮，它藏在 "editor.codeActionsOnSave" 这个对象里，拼错层级或格式错误就完全不触发。
- settings.json 中必须是这样写（注意大括号和引号）：
"editor.codeActionsOnSave": {"source.organizeImports": true} - 不能写成：
"editor.codeActionsOnSave.source.organizeImports": true（这是无效路径） - 不能只写
{"source.organizeImports": true}（缺外层 key，VSCode 会静默忽略） - 该功能只处理当前文件，不会跨文件补 import；想全局修复，得配 ESLint 插件 +
"eslint.codeAction.onSave.fixAll"
GTE 语义搜索插件真有用，但别指望它替代 import 配置
像基于 iic/nlp_gte_sentence-embedding_chinese-large 的插件，能用自然语言搜代码逻辑（比如搜“用户登出后清空 token”），但它不参与 import 解析链路——它查的是已存在的代码块，不是帮你生成 import { useAuth } from '@/composables/auth'。
真正卡住自动导入的，永远是那三样：语言服务是否加载（看状态栏）、配置文件是否存在（tsconfig.json/jsconfig.json）、VSCode 是否重启了对应服务器。语义搜索再强，也填不上这三处空白。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
