vscode代码片段tab不触发，主因是未通过命令面板创建导致文件未加载；必须用preferences: configure user snippets生成，文件名严格匹配语言id（如typescriptreact.json），且body须为字符串数组、右下角语言模式一致。
为什么写完 snippet 保存后 Tab 不弹出来？
不是代码没写对，而是 VSCode 根本没加载它——90% 的失效源于创建路径或文件名错误。
- 必须通过
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板，输入并选择Preferences: Configure User Snippets，不能手动在snippets/目录下新建文件 - 语言专属片段的文件名必须严格匹配 VSCode 内置语言 ID：
typescriptreact.json✅，tsx.json❌，vue.json✅（用于.vue文件），javascript.json✅（不是js.json） - 全局片段若用
.code-snippets后缀（如common.code-snippets），则必须放在系统 snippets 目录；若用.json后缀（如common.json），则只能通过命令面板“New Global Snippets file”生成，否则不识别 - 右下角语言模式显示的是当前编辑器的语言 ID（比如
TypeScript React），不是文件后缀——你在index.tsx里敲rfc，但片段存在javascript.json中，就不会触发
body 写成字符串数组还是单个字符串？
必须是字符串数组，且每行一条，换行靠数组元素分隔。VSCode 对这个结构极其敏感，错就静默忽略，不报错也不提示。
- ✅ 正确：
"body": ["function ${1:name}() {", "\t$0", "}"] - ❌ 错误：
"body": "function ${1:name}() {\n\t$0\n}"（单字符串 +\n） - ❌ 错误：
"body": ["function ${1:name}() {\n\t$0\n}"]（数组只有一项，含换行符） - 缩进必须显式写
"\t"，不能直接按 Tab 键插入空白字符（会变成不可见控制符，导致解析失败） - 多光标变量如
${1:name}和${1}是同步的；但两个$1（无大括号）会被忽略，不会跳转
如何让一个 prefix 在多个语言里生效？
别依赖“全局片段”自动跨语言——它只在所有语言上下文都启用时才触发，实际中常被语言专属片段覆盖。更可控的方式是显式声明作用域。
- 在语言专属文件（如
typescriptreact.json）里写，自然只对该语言生效 - 想在
.ts、.tsx、.vue的<script></script>里共用，就放全局文件，并加"scope": "typescript,typescriptreact,vue"字段（注意是逗号分隔字符串，不是数组） -
scope值必须是 VSCode 认识的语言 ID，查法：按Ctrl+Shift+P→Developer: Inspect Editor Tokens and Scopes，看顶部显示的languageId - 删掉
scope字段 ≠ 全局生效——它只对“无语言绑定”的临时文件（如未保存的Untitled-1）有效；真正跨语言，必须显式列出目标 ID
变量和占位符怎么用才不翻车？
变量展开失败、光标乱跳，通常是因为语法写错位置或编号冲突，而不是功能不可用。
- 所有变量必须用
${}包裹：$TM_FILENAME_BASE❌，${TM_FILENAME_BASE}✅ -
$1到$9是制表位编号，$0是最终光标位；重复编号（如两个${2:value}）会导致跳转异常，但不会报错 - 条件转换（如
${1/(true|false)/$1=='true'?'✅':'❌'/}）仅在 VSCode 1.86+ 支持，旧版本直接显示原始字符串 -
$CLIPBOARD插入剪贴板内容，但只在展开瞬间读取——复制后立刻触发，否则为空
{}，再逐行加字段验证，比反复猜更省时间。
