应禁用Vetur并启用Volar：Vetur不支持Vue 3的<script setup>和组合式API，与Volar冲突；需禁用/卸载Vetur、开启Volar的templateInterpolationService、正确声明defineProps类型、确保vue-language-features启用，并匹配TS版本。
Vue文件满屏红线但项目能正常运行
这基本是Volar和Vetur插件共存导致的解析冲突。VSCode同时加载两个Vue语言服务时，会互相覆盖语法校验逻辑，尤其在Vue 3 + TypeScript项目中，Vetur无法识别setup语法糖、defineProps、可选链?. 等特性，却仍强行校验，结果就是大量“合法代码被标红”。
常见表现包括：import语句报错、ref类型推导失败、“类型‘xxx’不存在‘data’属性”、?. 下划红线——这些都不是真实错误，而是Vetur用Vue 2解析器硬套Vue 3代码的结果。
- 确认是否同时启用了Volar和Vetur：打开VSCode扩展面板，搜索这两个名字，只要都处于启用状态，就立即禁用Vetur（Vue 3项目）或Volar（Vue 2项目）
- 禁用后必须重启VSCode窗口（
Developer: Reload Window），否则语言服务不会重载 - 如果项目是Vue 2，但你误装了Volar，也会出现类似问题——此时应禁用Volar，保留Vetur
Volar启用后TS类型提示仍不工作
Volar本身不提供TypeScript服务，它依赖VSCode内置的TS语言服务器。报错“类型正确但提示错误”，大概率是TS服务没连上项目配置，或用了错误的TS版本。
关键检查点：
立即学习“前端免费学习笔记（深入）”；
- 按
Ctrl+Shift+P输入TypeScript: Select TypeScript Version，务必选Use Workspace Version（即node_modules/typescript里的版本），不能用VSCode内置版本 - 检查
tsconfig.json中"include"是否包含"src/**/*.vue"，漏掉会导致.vue文件不参与TS类型检查 - 确保已安装
@vue/runtime-dom或vue的类型定义：运行npm list vue，若输出中没有types字段，执行npm install -D vue - 执行
TypeScript: Restart TS server，等待几秒再看提示是否恢复
可选链?. 、空值合并??持续报错
这类语法报错90%以上不是ESLint或TS配置问题，而是Vetur旧版本（如v0.11.0）根本不认识ES2020+语法。即使你升级了ESLint，Vetur自己的语法解析器仍是瓶颈。
解决路径很直接：
- 打开VSCode扩展面板，找到Vetur，点击更新按钮（若不可点，先卸载再重装最新版，当前稳定版为
v0.38.0） - 更新后仍报错？说明Volar和Vetur还在后台共存——彻底禁用Vetur，哪怕只是暂时停用
- 如果坚持用Vetur（比如维护老Vue 2项目），需在
package.json中显式关闭对应规则："eslintConfig": {"rules": {"@typescript-eslint/ban-ts-comment": "off"}}，但这只是掩盖问题
模板根节点报错“template must have exactly one root element”
这是Vetur把Vue 3项目当Vue 2处理的典型症状。Vue 3支持多根节点模板，但Vetur默认按Vue 2规则校验，强制要求单根。
临时绕过方法（仅限Vue 3项目）：
- 在项目
package.json中添加："eslintConfig": {"rules": {"vue/no-multiple-template-root": "off"}} - 保存后必须重启VSCode，否则规则不生效
- 更彻底的做法：卸载Vetur，改用Volar +
Vue Language Features插件组合，它们原生支持Vue 3模板语义
真正容易被忽略的是：Volar和Vetur的冲突不是“谁优先”的问题，而是“谁接管.vue文件”的权限争夺。VSCode只允许一个插件注册vue语言ID，一旦冲突，校验逻辑就会随机失效或降级。不要试图调高某个插件的优先级，直接卸载另一个才是唯一可靠解法。
