vscode代码片段不提示主因是languageid错位与body非数组格式；需用developer: inspect editor tokens and scopes确认真实languageid并严格匹配文件名，且body必须为字符串数组（如["console.log($1);"]），二者错误占失效问题90%。
代码片段不提示，八成不是片段写错了，而是 VSCode 根本没把它和当前文件“对上号”——语言模式（language mode）错位是最常见、也最容易被忽略的根源。
怎么确认当前文件用的是哪个 languageId
右下角状态栏显示的“JavaScript”“Python”之类只是友好名称，真正起作用的是背后那个 languageId。比如：.tsx 文件的 languageId 是 typescriptreact，不是 typescript 或 tsx；.vue 文件默认是 vue，但某些插件可能设为 vue-html 或 vue-postcss。
- 打开目标文件（如
App.tsx） - 按
Ctrl + Shift + P（Windows/Linux）或Cmd + Shift + P（macOS） - 输入并执行
Developer: Inspect Editor Tokens and Scopes - 看弹窗右上角显示的
Language ID—— 这才是你代码片段文件名该严格匹配的值
代码片段文件名必须和 languageId 完全一致
VSCode 只认名字完全匹配的 JSON 文件，大小写、拼写、后缀一个都不能错。哪怕只差一个字母，整个文件都会被静默忽略。
- 片段文件必须命名为
{languageId}.json，例如：typescriptreact.json、python.json、vue.json -
js.json❌（正确应为javascript.json） -
TSX.json❌（大小写敏感，必须小写） -
typescript-react.json❌（不能用短横线，只能用驼峰或下划线） - 路径必须在用户代码片段目录下：
code --list-extensions --show-versions不管用，直接查 VSCode 设置里 “Configure User Snippets” 跳转的位置
片段 JSON 里 body 字段必须是字符串数组
哪怕只有一行代码，body 也必须是数组，不是字符串。这是最常因手快写错而失效的点。
- ✅ 正确：
"body": ["console.log($1);"] - ❌ 错误：
"body": "console.log($1);"（少了一层方括号） - ❌ 错误：
"body": ["console.log($1);",]（末尾逗号在 JSON 中非法） - 占位符必须用英文半角符号：
$1、${2:default}，不能是中文 $１ 或全角括号 - 整个 JSON 必须是 UTF-8 编码且无 BOM；用 VSCode 自己保存，别用记事本或 Sublime 直接改
光标位置和上下文不满足触发条件
即使片段加载成功，也可能因为光标卡在“不该触发”的地方而毫无反应。
- 片段默认只在普通代码区域触发：不能在字符串内（
"<cursor>"</cursor>）、不能在注释中（// <cursor></cursor>）、不能在 JSX 属性值里（<div classname="<cursor>"></div>） - 检查设置：
"editor.suggest.showSnippets"必须为true（默认开启，但可能被工作区.vscode/settings.json覆盖） - 某些格式化插件（如 Prettier）或 AI 补全工具会劫持补全逻辑，临时禁用它们测试是否冲突
- 按
Ctrl + Space手动唤出建议列表，看片段是否出现在“Snippet”分类下——如果没出现，说明根本没加载；如果出现了但不响应 Tab，说明是上下文问题
languageId 匹配错误和 body 数组写法错误，这两处几乎占了所有“片段不提示”问题的 90%。其他环节出问题时，通常至少还能看到片段出现在补全列表里；而这两处一错，VSCode 就当它不存在，连日志都不会打。
