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

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


















