必须禁用Vetur,否则其语言服务器会劫持.vue文件,导致Volar无法接管——右下角不显示“Volar (Take Over)”,defineProps报红、模板无提示、ref不解包;需禁用Vetur、启用Volar Take Over Mode、手动设.vue为vue语言模式、确保根目录tsconfig.json正确且排除项不误删.vue文件。

Volar 是 Vue 3 唯一推荐的高亮与语言支持插件,Vetur 必须禁用——装错或共存,defineProps 就报红、 里变量没提示、ref 不解包,不是配置问题,是根本没走对语言服务路径。
Vetur 已归档,其语言服务器和 Volar 底层冲突,VSCode 可能自动禁用其中一个但行为不可控。即使你只关了 Volar 默认不接管 .vue 文件,只当普通 TS 插件用。不开 Take Over, 即使装了 Volar,VSCode 仍可能把 .vue 当作 Plain Text 或 HTML 处理,尤其从 WebStorm 或旧项目迁移后。此时高亮只在 Volar 的类型服务强依赖 为什么必须禁用 Vetur 而不是“关掉几个选项”
vetur.validation.template,它仍会劫持 .vue 文件的语言模式,导致 Volar 的类型推导完全失效。
Ctrl+Shift+X),搜 Vetur → 点击齿轮图标 → 选「禁用」(不是卸载,也不是只关配置)Volar(发布者为 Vue Team,蓝标认证),不是 “Volar for Vue 2” 或其他变体启用 Take Over Mode 并验证是否真正接管
defineProps 泛型不推导、ref 不自动解包、 里写 v-mo 按 Tab 不补全——所有 Vue SFC 特性都残废。
Ctrl+Shift+P 输入 Volar: Take Over Mode → 回车 → 弹窗点 Yes
Volar (Take Over)(不是 Vue、Vue (Volar) 或 HTML)Ctrl+Shift+P → Developer: Toggle Developer Tools → Console 里搜 Registering Vue language features,有日志才算激活成功确保 .vue 文件被识别为 vue 语言模式
或 <script></script> 块局部生效, 标签无颜色、变量无提示。
Plain Text)→ 选 Configure File Association for '.vue' → 输入 vue 回车(注意:不要选 Vue (Volar) 或 Vue HTML).vscode/settings.json 中加:{"files.associations": {"*.vue": "vue"}}
test.vue,确认右下角显示 vue,且 内标签有颜色、<script setup lang="ts"></script> 里能 F12 跳转到 ref
tsconfig.json 缺失或 exclude 错误会导致 defineProps 报红
tsconfig.json。没有它,或它把 node_modules 排除,@vue/runtime-dom 类型就加载不了,defineProps 直接变未定义——这不是 ESLint 配置问题,是语言服务器压根找不到类型定义。
最常被忽略的是「彻底重启 VSCode 窗口」——改完 tsconfig.json(空文件也行),不能只有 jsconfig.json(除非含 "allowJs": true)exclude 字段:不能写 "**/node_modules"、"node_modules" 或 "src/**/*.vue",否则 Volar 找不到 @vue/language-core
pnpm store path 查路径,macOS 上需确认 VSCode 有全盘访问权限(否则读不到 store 里的类型)files.associations、开完 Take Over、禁用完 Vetur,不关掉整个窗口再重开,Volar 的语言服务不会重新初始化,所有配置等于白设。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











