vscode自定义代码片段必须同时满足路径命名匹配语言id、json结构合法、右下角语言模式一致三条件才生效；需通过命令面板创建文件，body必须为字符串数组，prefix全小写无空格，$0须显式声明。
VSCode 自定义代码片段不是“配完就自动生效”，而是必须同时满足三个硬性条件：文件路径和命名完全匹配语言 ID、JSON 结构零错误、当前编辑器语言模式（右下角显示）与之严格一致——缺一不可，错一个就静默失效。
如何创建 snippet 文件：路径、后缀、语言 ID 必须全对
VSCode 不会扫描你随便扔进 snippets/ 目录的 JSON 文件，必须通过命令面板触发创建流程，否则文件根本不会加载。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并选择Preferences: Configure User Snippets - 想全局可用 → 选
New Global Snippets file，输入common.json（不是common.code-snippets） - 只在 JavaScript 中生效 → 直接从列表选
javascript，VS Code 自动创建并打开javascript.json - TypeScript React 文件要生效？必须选
typescriptreact，对应文件名是typescriptreact.json；tsx.json或ts.json都无效 - 工作区级片段：手动在项目根目录建
.vscode/snippets/typescriptreact.json（注意.vscode是隐藏文件夹）
JSON 格式怎么写才不静默失败
VSCode 对 snippet JSON 极其敏感：少一个逗号、body 写成字符串而非数组、引号不闭合、键名拼错——全都不报错，只是你的 prefix 永远没反应。
-
prefix必须是字符串，如"log"，不能是["log"]或带空格的"console log" -
body必须是字符串数组，每行一条语句：["console.log($1);", "$0"]✅；"console.log($1);"❌；["console.log($1);\n$0"]❌（\n在数组里无意义） - 变量必须用
${}包裹：${TM_FILENAME_BASE}✅；$TM_FILENAME_BASE❌（旧语法已弃用） - 占位符编号不能重复：
$1和$1同时出现会导致 Tab 跳转异常；$0建议显式加上，明确最终光标位置 - 整个文件顶层必须是对象
{}，不能是数组[{}]，也不能多一层包装
为什么输入 prefix 按 Tab 没反应
90% 的失效不是语法问题，而是语言上下文没对上。VSCode 的 snippet 是严格按右下角显示的语言 ID 激活的，和文件后缀无关。
- 你在
App.tsx里试log，但右下角显示的是TypeScript React→ 片段必须放在typescriptreact.json中 - 右下角显示
Plain Text或Vue？点击它手动切换为准确 ID，比如TypeScript React、JavaScript、vue - 装了 Vetur 或 Vue Language Features 后，
.vue文件默认走vue模式，得单独配vue.json，不能复用javascript.json - Prettier、ESLint、IntelliSense 等扩展可能劫持 Tab 行为 → 禁用所有扩展后重试
- 输入
prefix后没小灯泡提示？说明文件根本没加载 → 先删空内容，只留{}，保存，再一行行加字段验证
变量和占位符的实际用法
变量不是摆设，但拼错一个字符就变成纯文本。真正卡住人的往往是大小写、括号、正则语法这些细节。
-
${1:default}表示带默认值的占位符，编辑时可直接修改；${1: ${2:value}}不支持，禁止嵌套 -
${TM_FILENAME_BASE/(.*)/${1:/pascalcase}/}可将文件名转 PascalCase，但漏掉任意/或写错:pascalcase就失效 -
$CURRENT_YEAR、$CURRENT_MONTH等内置变量无需大括号，但仅限少数几个；其余一律用${} - 多个
${1:xxx}会同步更新，适合 props 名和类型定义联动；$0是最终停留位，不是编号终点 - 缩进用空格，别用 Tab —— VSCode 会原样保留，导致生成代码缩进错乱
最常被忽略的不是语法多难，而是右下角语言 ID 大小写是否一致、JSON 是否多了一个逗号、body 有没有被误写成字符串、.vscode 目录是不是真隐藏了——这些细节不逐项验证，再好的模板也等于没写。
