Volar与Vetur不能共存，因二者均注册.vue文件语言服务但底层协议不兼容，VS Code会随机启用其一，导致<script setup>类型不识别、defineProps未定义、指令无提示、跳转失效及状态栏闪烁；必须卸载Vetur并配置files.associations和typescript.tsdk。

Volar 是唯一必须装的插件，其他都是可选辅助；Vetur 必须卸载，否则语法高亮和 defineProps 类型提示直接失效。

为什么 Volar 不能和 Vetur 共存

Volar 和 Vetur 都会注册 .vue 文件的语言服务，但底层协议不兼容。同时启用时，VS Code 会随机选择其中一个接管解析，结果往往是：

• <script setup> 块里 TypeScript 类型完全不识别，defineProps、defineEmits 显示为未定义
• 模板中 v-if、v-for 等指令无参数提示，属性补全只显示 HTML 原生属性
• 右键「转到定义」跳转失败，或跳到错误位置
• 状态栏语言模式反复在 “Vue” 和 “Plain Text” 之间闪烁

解决方式只有：进入扩展面板 → 搜索 Vetur → 点击「禁用」或「卸载」→ 重启 VS Code。

装完 Volar 后必须手动设置文件关联

即使安装了 Volar，VS Code 默认仍可能把 .vue 文件当作纯文本处理——这不是 bug，是设计行为。必须显式告诉编辑器：“所有 .vue 文件都用 Vue 语言模式打开”。

vue-component-analyzer

递归分析 Vue 项目组件依赖，从入口文件生成组件层级图，支持 Vue 2/3，输出组件名、文件路径和属性。适用于分析组件结构、排查依赖或了解项目架构。

下载

立即学习“前端免费学习笔记（深入）”；

• 临时方案：打开任意 .vue 文件 → 点击右下角语言模式（如显示“Plain Text”）→ 选择 Vue
• 永久生效：打开设置（Ctrl+,）→ 搜索 files.associations → 编辑 settings.json，加入：

  "files.associations": { "*.vue": "vue" }

• 如果项目含 .vue.html 或自定义后缀（如 .nvue），也要一并加进去：

  "*.nvue": "vue"

typeScript.tsdk 指向错误会导致宏无法识别

Volar 的类型推导严重依赖项目本地的 TypeScript 版本。如果 typescript.tsdk 指向全局 TS（比如通过 npm install -g typescript 安装的），defineProps<{…}>() 这类宏将无法被解析，编辑器报错 Cannot find name 'defineProps'。

• 确认路径：检查项目根目录是否存在 node_modules/typescript
• 配置方法：在工作区 settings.json 中添加：

  "typescript.tsdk": "./node_modules/typescript/lib"

• 注意：路径末尾必须带 /lib，少写会静默失败
• 若用 jsconfig.json 而非 tsconfig.json，需确保含 "allowJs": true 和 "checkJs": true

Vue VSCode Snippets 提升指令输入效率

它不解决语法高亮问题，但能减少手敲常见结构的出错率。真正实用的不是“全代码块”，而是精准触发的指令片段：

• 在 <template> 中输入 vfor → 补全为：

  <div v-for="item in list" :key="item.id">{{ item }}</div>

• 输入 vmodel → 补全为：

  <input v-model="value" />

• 输入 vbind → 补全为：

  :class="className"

  （光标停在引号内，方便继续输表达式）
• 不推荐用 vbase 生成完整骨架：Vue 3 项目通常已用 Vite 或 Vue CLI 初始化，自带标准结构

真正容易被忽略的是：这些片段只有在语言模式为 Vue 且 Volar 正常运行时才生效。如果指令没提示，先回头检查前三个环节——90% 的问题出在 files.associations 或 typescript.tsdk 配置上。