VSCode 中 Vue 3 开发需正确配置 Volar(禁用 Vetur)、启用宏支持、设置 vue.json 片段为 script setup、交由 Volar 格式化、配好 tsconfig.json paths 路径别名,否则类型提示失效。

VSCode 里写 Vue 不是靠“自动部署模块”,而是靠正确配置语言服务、代码片段和格式化链路——否则你连 ref() 的类型提示都看不到,更别说“一键生成”或“自动部署”这种虚词。
Vue 3 项目必须禁用 Vetur,只留 Volar
两个插件同时启用会直接让 script setup 中的类型推导失效,defineProps 变成 any,ref() 解构后失去类型。这不是 bug,是设计冲突。
- Vetur 是 Vue 2 时代的产物,不理解 Vue 3 的编译宏(
defineProps、defineEmits) - Volar 才是 Vue 官方维护的语言服务器,但默认不开启宏支持
- 必须在 VSCode 设置中搜索
Vue > Experimental: Vue Macros并勾选,然后关闭并重新打开整个窗口(不是重载窗口)
代码片段要匹配项目语法,别抄过时模板
你搜到的很多 vue.json 示例还在用 Options API 的 export default { data() { ... } },而你的项目大概率是 <script setup lang="ts"></script>。模板错位会导致每次新建文件都要手动删改。
- 推荐这样写
vue.json的body片段: """<script setup lang="ts">"</script>"import { ref, reactive } from 'vue'"""""-
"prefix"值建议设为vue3或sfc,避免和旧项目vue前缀冲突
.vue 文件格式化必须交给 Volar,不是 Prettier
如果你在保存时发现 缩进炸开、属性被强行折行、v-if 和 v-for 换行错乱,大概率是 Prettier 在瞎管 .vue 文件。
从零开始编排 SpringBoot+Vue 全栈项目工作流,适用于新建全栈项目或完整脚手架请求,触发后依次调用 product‑spec‑builder(需求调研)等模块。
- 在 VSCode 设置中搜
prettier.vue,把Prettier: Vue Files Suffixes清空(留空或删掉vue) - 确保
files.associations里有"*.vue": "vue" - 检查右下角语言模式是否显示 “Vue” —— 如果是 “HTML” 或 “Plain Text”,说明文件没被正确识别
- Volar 自带的格式化器对
<script setup></script>和模板语法的理解远超 Prettier
路径别名跳转失败?不是插件问题,是 tsconfig.json / jsconfig.json 没配对
@/components/HelloWorld.vue 点不进去、重命名不联动、IntelliSense 提示 “Cannot find module”,90% 是因为 baseUrl 和 paths 没写进项目级配置,而不是插件没装全。
- Vue 3 + TS 项目:确认
tsconfig.json的compilerOptions包含: "baseUrl": "./""paths": { "@/*": ["src/*"] }- Vue 2 + JS 项目:同理,
jsconfig.json必须存在且含相同字段 - Vite 的
resolve.alias是运行时配置,VSCode 不读它;只有tsconfig.json/jsconfig.json才是编辑器认的“路径字典”
最常被忽略的其实是:Volar 的类型服务依赖项目配置文件真实存在且语法合法。一个多余的逗号、一个未闭合的引号,就足以让整个 .vue 文件的智能提示静默失效——但它不会报错,只会“看起来正常”。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










