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>。模板错位会导致每次新建文件都要手动删改。

