<p>Vue - Official（原Volar）是Vue 3项目唯一支持defineProps/defineEmits类型推导和模板跳转的核心插件；必须将.vue文件手动关联为Vue语言模式、禁用Vetur、确保tsconfig.json含"types": ["vue"]且include涵盖.vue文件，否则智能提示全面失效。</p>
装对插件比多装插件更重要。Vue 3 项目里，Vue - Official（原 Volar）是唯一能支撑 defineProps、defineEmits 类型推导和模板内跳转的语言服务，其他插件再全也补不回这个缺口。
确认 .vue 文件已绑定到 Vue 语言模式
这是所有功能生效的前提。VSCode 默认可能把 .vue 当作 HTML 或纯文本处理，导致高亮、补全、类型提示全部失效。
- 打开任意
.vue文件，看右下角状态栏是否显示 Vue（不是 HTML / Plain Text） - 如果不是，点击该文字 → 选 Configure File Association for '.vue' → 手动设为
vue - 检查设置中是否存在
"files.associations": { "*.vue": "html" }这类冲突配置，必须删掉 - 禁用
Vetur：在设置里搜vetur.enable，确保关闭；或直接卸载
必须安装的三个核心插件及其关键配置
不是越多越好，这三者构成最小可行闭环：
-
Vue - Official：提供 SFC 三部分语法支持、<script setup></script>类型推导、组件跳转。无需额外配置，但需确保tsconfig.json中有"types": ["vue"]，否则defineProps<{}>()无类型提示 -
Vue 3 Snippets：输入v3setup直接生成带lang="ts"的完整模板；v3ref、v3onmounted等前缀覆盖高频操作。建议在设置中启用editor.tabCompletion: "onlySnippets"避免与自动补全冲突 -
Path Intellisense：解决@/components/xxx路径手写易错问题。必须在settings.json中加映射："path-intellisense.mappings": { "@": "${workspaceFolder}/src" }
常见补全失效的底层原因
不是插件没装好，而是语言服务上下文断了。典型表现包括：模板里不提示组件名、ref 没类型、useRouter 不自动导入。
立即学习“前端免费学习笔记（深入）”；
- 项目未安装
@volar/vue-language-server（Volar 依赖它解析 SFC）：运行npm install --save-dev @volar/vue-language-server - TS 服务没加载
.vue：确认tsconfig.json的include包含"src/**/*"或显式列出"src/**/*.vue" - 用了
unplugin-vue-components自动注册组件，但没把生成的src/components.d.ts加进tsconfig.json.include - 改完配置后只刷新窗口，没执行
Developer: Restart Extension Host或重启 VSCode
最常被忽略的是 tsconfig.json 里漏掉 "types": ["vue"]，以及右下角语言模式没手动切对——这两点一错，整个 Vue 3 的智能提示就退化成纯文本高亮，再多插件也救不回来。
