直接写模板易漏lang="ts"、scoped、setup标记及ref类型错误，且难满足defineOptions等规范；插件生成可确保一致性，需正确配置vue.json路径、prefix，并补全defineProps/defineEmits、import声明及生命周期导入。
为什么直接写模板不如用插件生成
手写 Vue3 + TS + Setup 组件模板容易漏掉 lang="ts"、scoped、setup 语法糖标记，或把 ref 写成 Ref 导致类型报错。更麻烦的是，团队规范要求每个组件必须含 defineOptions 或特定注释头，人工复制粘贴极易出错。插件生成不是“偷懒”，而是把确定性逻辑交给机器执行，人专注业务逻辑。
如何配置 vue.json 代码片段并确保生效
VSCode 自带的 Vue 片段不支持 TS + Setup 混合语法，必须手动配置 vue.json。关键点有三个：
- 路径必须是
%APPDATA%\Code\User\snippets\vue.json（Windows）或~/Library/Application Support/Code/User/snippets/vue.json（Mac），放错位置不会触发 -
prefix值不能含空格或特殊字符，v3可用，vue3 template不行 - 如果输入
v3后无提示，检查是否在.vue文件内且光标位于空白处——在<script></script>标签里或注释后，片段不会激活
生成后必须手动补全的三处细节
AI 或片段生成的代码只是起点，以下三项不补全，编译会直接失败：
-
defineProps和defineEmits必须显式声明，不能靠推导——否则 TS 类型检查失效，props会变成any -
ref/reactive需从vue显式导入，片段里常漏掉import { ref } from 'vue' -
onMounted等生命周期必须从vue导入，不能写成mounted()这种 Options API 风格
团队统一模板怎么落地不靠人盯
靠开发者自觉改 vue.json 不现实。真正可落地的方式是：
- 把标准片段打包进公司内部 VSCode 设置同步服务，新成员装完插件就自动同步
- 用
vsce打包一个轻量插件，只做一件事：注入预设的vue.json到用户 snippets 目录 - 禁止手动编辑
vue.json，所有变更走 Git 管理 + CI 校验，避免本地覆盖
模板不是越全越好，关键是字段名、导入语句、生命周期调用方式这些硬性约束项必须和 ESLint 规则对齐——否则生成即报错，反而拖慢开发节奏。
