代码片段不生效主因是VSCode未加载：文件名与languageId不匹配（如tsx文件需typescriptreact.json）、路径不在用户snippets目录、body未用字符串数组格式（必须["..."]而非"..."）。
代码片段不生效，八成不是写错了，而是 VSCode 根本没加载它——文件名错位、路径不对、body 格式非法，三者占失效原因的 90%。
怎么确认当前文件的真实 languageId
右下角状态栏显示的“JavaScript”“TypeScript”只是友好名，真正起作用的是背后那个 languageId。比如：.tsx 文件的 languageId 是 typescriptreact，不是 typescript 或 tsx；.vue 文件默认是 vue，但某些插件可能设为 vue-html。
实操步骤：
- 打开目标文件（如
App.tsx） - 按
Ctrl + Shift + P（Windows/Linux）或Cmd + Shift + P（macOS） - 输入并执行
Developer: Inspect Editor Tokens and Scopes - 看弹窗右上角显示的
Language ID——这就是你片段文件名必须严格匹配的值
片段文件名和存放路径必须完全合规
VSCode 只认名字完全匹配的 JSON 文件，大小写、拼写、后缀一个都不能错。哪怕只差一个字母，整个文件都会被静默忽略。
常见错误写法：
-
js.json❌（正确应为javascript.json） -
TSX.json❌（大小写敏感，必须小写） -
typescript-react.json❌（不能用短横线，只能用驼峰或下划线）
路径必须在用户代码片段目录下，别放在工作区或插件目录里。直接在命令面板中运行 Configure User Snippets，跳转过去的位置才是唯一有效路径。
body 字段必须是字符串数组，不是字符串
这是最常因手快写错而失效的点。哪怕只有一行代码，body 也必须是数组，不是字符串。
✅ 正确："body": ["console.log();"]
❌ 错误："body": "console.log($1);"（少了一层方括号）
❌ 错误："body": ["console.log($1);",]（末尾逗号在 JSON 中非法）
其他易错点：
-
prefix必须是字符串，不能是数组或数字 - 变量如
$TM_SELECTED_TEXT要成对出现，避免漏掉引号或写成$tm_selected_text（大小写敏感） - 正则转换语法
${fileBasename/regex/format/options}中的斜杠不能省，选项如i或g要写在最后
为什么改完还是不提示？检查 editor.suggest.showSnippets
即使片段文件完全合规，如果设置里关掉了提示开关，VSCode 就不会把它放进智能感知列表。
打开 settings.json，确认有这一行：
"editor.suggest.showSnippets": true
如果没有，手动加上。这个配置默认是 true，但某些团队模板、远程开发容器或旧版迁移时可能被覆盖为 false，导致所有自定义片段静默失效。
真正容易被忽略的，是 languageId 和文件名之间那毫厘之差——VSCode 不报错、不警告，只安静地跳过整个文件。每次改完片段，先用 Inspect Editor Tokens and Scopes 对一遍，比反复重写十遍都管用。
