vscode代码片段需严格匹配路径、文件名、json结构和语言模式四者才生效；正确配置方法是通过命令面板打开用户代码片段，全局用common.json，语言级选对应语言id（如typescriptreact），json结构必须规范且编码为utf-8无bom。
VSCode 的代码片段不会“写完就生效”，必须同时满足路径、文件名、JSON 结构、语言模式四者严格匹配，缺一不可。手动建错一个字符，prefix 就永远不弹出来。
怎么打开正确的 snippets 配置文件
别自己去 %APPDATA%\Code\User\snippets\（Windows）或 $HOME/Library/Application Support/Code/User/snippets/（macOS）里新建 JSON 文件——VSCode 不会加载它。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并选中Preferences: Configure User Snippets - 想全局用：选
New Global Snippets file，**必须输common.json**（不是common.code-snippets） - 只在 JavaScript 里用：直接从列表选
javascript，VSCode 自动创建并打开javascript.json - TypeScript React 文件要生效？必须选
typescriptreact，不是tsx或ts—— 语言 ID 必须完全一致
JSON 格式写错一个逗号就静默失效
VSCode 不报错，只让你纳闷“为什么 Tab 没反应”。关键字段只有 prefix、body、description，其他全可选，但结构不能错。
-
body必须是字符串数组：["console.log($1);", "$0"]✅；"console.log($1);"❌ - 变量必须用
${}包裹：${TM_FILENAME_BASE}✅；$TM_FILENAME_BASE❌（旧语法已失效） - 占位符编号不能重复：
$1和$1同时出现会导致 Tab 跳转异常；$0建议显式加上，明确最终光标位置 - 文件编码必须是 UTF-8 无 BOM，尤其 Windows 下用记事本另存时容易带 BOM，导致整个文件静默不加载
为什么输入 prefix 按 Tab 没反应
90% 是语言模式不匹配。VSCode 的 snippet 只在右下角显示的语言模式下激活，不是“写了就能用”。
- 检查右下角语言标识：比如你写了
typescriptreact.json，但当前文件是.ts，默认语言模式可能是TypeScript而非TypeScript React - 临时把文件另存为
.js，再试一次；如果这时能触发，说明就是语言 ID 错配 - 手动切换语言模式：
Ctrl+Shift+P→ 输入Change Language Mode→ 选准确的项（如TypeScript React） - 禁用 Prettier、ESLint、IntelliSense 等扩展再试——它们可能劫持了 Tab 行为
工作区级 snippet 怎么配才生效
工作区 snippet 不是靠“选 New Workspace Snippets”生成的，得手动建路径，且 VSCode 对隐藏目录名敏感。
- 在项目根目录下建文件夹：
.vscode/snippets/（注意.vscode是隐藏目录，别写成vscode或.VSCode） - 里面放
javascript.json或typescriptreact.json，命名规则和全局/语言级完全一致 - 文件内容结构一样：
prefix、body数组、description一个都不能少 - 改完后建议执行
Developer: Reload Window，比重启更快，确保新配置加载
最隐蔽的失效点往往不是逻辑，而是 JSON 里多了一个逗号、少了一个引号、body 没包成数组、或者右下角语言模式根本没切对——这些地方不报错，只沉默。每次加字段前先删空内容，只留 {}，保存后再一行行加，是最稳的调试方式。
