按tab未触发代码片段的主因是prefix错误或语言模式不匹配；vs code依赖language id（如vue、typescript）而非文件后缀，且prefix须为小写字符串、严格匹配光标前内容，同时需确保文件语言id与snippet的scope一致。
为什么按了 Tab 却没触发代码片段？
大概率是 prefix 写错了，或者当前文件语言模式不匹配。VS Code 只认语言 ID（比如 vue、typescript），不是看文件后缀名；.ts 文件如果被识别成 javascript，那 typescript 片段就压根不会出现。
-
prefix必须是字符串，不能写成数组或数字；大小写敏感，Log和log是两个不同片段 - 没保存 JSON 文件——VS Code 不会热重载未保存的
.code-snippets文件 - 检查右下角语言标识：点击它，确认选的是正确语言 ID（如 Vue 单文件必须是
vue，不是vue-html） - 片段定义里写了
"scope": "vue"，但当前文件语言 ID 是html，照样不生效
如何为 .vue 文件快速生成标准结构？
Vue 3 的 <script setup></script> + <template></template> + <style scoped></style> 结构，靠手敲容易漏掉 lang="ts" 或 scoped，用片段能一步到位。
- 在命令面板（
Ctrl+Shift+P）中输入 “Configure User Snippets”，选择vue - 填入类似这样的片段：
{
"vue3-sfc": {
"prefix": "sfc",
"body": [
"<template>",
" <div class='\"${1:app-container}\"'>$2</div>",
"</template>",
"<script setup lang='\"ts\"'>",
"$0",
"</script>",
"<style lang='\"scss\"' scoped>",
"</style>"
],
"description": "Vue 3 SFC template with setup and scoped style"
}
}
-
$1是组件类名占位符，$2是模板内容位置，$0是最终光标停驻点（通常设在<script setup></script>里） - 别忘了加
lang="ts"和scoped，否则后续类型检查或样式隔离会出问题
全局片段 vs 语言专属片段怎么选？
全局片段（如 log、todo）适合跨语言通用逻辑；语言专属片段（如 vue、python）才能精准控制作用域和语法兼容性。
- 全局片段存在路径：
~/.vscode/snippets/common.code-snippets（Windows 是%USERPROFILE%\AppData\Roaming\Code\User\snippets\） - 语言专属片段路径由 VS Code 自动管理，不要手动创建；选
javascript就生成javascript.json，它对.js、.jsx都生效 - 同一个
prefix在不同语言文件里可以指向不同内容——比如for在 Python 里生成for item in iterable:，在 JavaScript 里生成for (let i = 0; i - 工作区级片段（
.vscode/xxx.code-snippets）只对当前项目生效，适合团队统一规范，但要注意 Git 提交时别漏掉.vscode目录
占位符 $1、$2、$0 和变量插值怎么用才不翻车？
占位符顺序错、嵌套太深、变量名拼错，都会让插入后光标乱跳或默认值不生效。
-
$1到$9是顺序跳转位，$0是最终停留点；不要跳号（比如只有$1和$3，中间缺$2） - 带默认值写成
${1:default}，不是$1:default；括号不能少，否则解析失败 - 常用变量如
${TM_FILENAME_BASE}能自动填入当前文件名（不含扩展名），适合生成组件名或 store 名，但只在片段插入瞬间求值，改文件名后不会自动更新 - 避免在
body数组里混用单双引号——JSON 要求双引号，所有字符串都得用"包裹，包括"<script setup lang='\"ts\"'>"</script>里的转义
最常被忽略的是：片段保存后必须重启编辑器或重新打开文件才能确保语言模式重载，尤其改过 scope 或语言 ID 时。光刷新窗口没用，得让 VS Code 重新识别当前文件的语言上下文。
