VSCode 新建文件模板依赖 snippets 机制而非原生功能；scope 决定触发条件，需匹配语言模式；prefix/body 控制触发与内容填充；全局、工作区、插件模板适用场景不同，配置后须重载窗口、确认语言模式、避免 prefix 冲突。
VSCode 本身不提供“新建文件即填充模板”的原生功能，所有看似一键生成的文件模板，底层都依赖 snippets（代码片段）机制或第三方插件模拟。直接装插件点右键“新建 Vue 文件”大概率是障眼法——它只是调用 VS Code 原生新建逻辑 + 临时填入内容，不可靠、难维护、不跨环境。
为什么scope字段决定模板能否触发
在 vue.json 或 python.json 中定义 snippet 时，"scope": "vue" 不是可选项，而是开关。VS Code 只有在当前编辑器语言模式为 vue 时，才会匹配并激活该 snippet。常见错误包括：
- 把
scope写成html或javascript，导致 .vue 文件里输入vue按 Tab 没反应 - 没装 Volar 插件，或 Volar 被禁用，VS Code 根本无法识别
vue语言模式，scope形同虚设 - 文件后缀是 .vue，但右下角语言模式显示为 “Plain Text”，此时必须手动点击切换为
Vue
验证方式：打开一个 .vue 文件，按 Ctrl+Shift+P 输入 “Change Language Mode”，确认当前 mode 是 Vue。
prefix 和 body 的实操要点
prefix 是你在编辑器里敲的触发词，比如 vue、newcpp、pt；body 是展开后插入的内容数组。关键细节：
-
body中每行是一个字符串，换行用空字符串""表示，不是\n - 光标占位符用
$1、$2、$0（最终停留位），别写成${1}或$1$ - 缩进用制表符
\t或空格字符串，但要和项目实际缩进风格一致，否则保存时可能被 Prettier 自动修正 - Vue 3
<script setup>模板里不要写export default，否则运行时报Component is missing template or render function
示例（正确）：
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
{
"Vue SFC": {
"scope": "vue",
"prefix": "vue",
"body": [
"<template>",
" <div>$1</div>",
"</template>",
"",
"<script setup>",
"$2",
"</script>",
"",
"<style scoped>",
"$3",
"</style>"
]
}
}
全局模板 vs 工作区模板 vs 插件模板怎么选
三者适用场景完全不同，混用反而增加维护成本：
- 个人常用结构（如 Python 文件头、C++ LeetCode 模板）→ 放
python.json/cpp.json，路径是~/.vscode/snippets/（全局） - 团队统一组件规范（如
rfc生成 React 函数组件）→ 放项目根目录.vscode/snippets/javascript.json，Git 提交，成员开箱即用 - 插件（如 File Templates）适合批量建文件夹结构（
src/components/xxx/+index.ts+index.test.ts），但它不解决单文件内容填充，且模板变量（如${fileName}）只在插件内生效，和 snippet 机制无关
注意：File Templates 插件生成的文件，其内容仍是硬编码，不能响应语言模式切换，也无法使用 $1 光标跳转 —— 这些只有原生 snippet 支持。
配置完不生效？先查这三件事
90% 的“配置失败”问题出在这三个地方：
- VS Code 没重载窗口：改完
json文件后，按Ctrl+Shift+P输入 “Developer: Reload Window” 手动重载 - 文件未保存或未设置语言模式：新建的
xxx.vue是“未命名”状态，VS Code 默认语言是 Plain Text，必须先保存为 .vue 后缀，再确认右下角 language mode 是Vue - 前缀冲突：如果已有其他 snippet 也用了
vue作为prefix（比如 HTML 模板），VS Code 会弹出模糊匹配列表，需用方向键选中目标项再回车
最稳的验证方式：打开一个已正确识别语言模式的文件（如已有内容的 .vue），输入 prefix，看是否立刻出现带描述的补全提示 —— 不需要按 Tab，悬停就能看到 body 预览。
