VSCode自定义代码片段不触发的主因是scope与语言ID不匹配；需确认文件语言模式、验证JSON语法、检查作用域优先级及远程配置，避免前缀冲突。
VSCode 自定义代码片段不触发：检查 scope 和文件关联是否匹配
自定义片段写完却完全不出现，最常见原因是 scope（作用域）配置错误。VSCode 不是按文件后缀匹配片段，而是依赖语言标识符（language ID），比如 javascript、typescriptreact、vue，而非 .js 或 .vue 后缀。
- 打开目标文件，按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Change Language Mode，确认右下角显示的语言 ID 是否与片段中"scope"一致 -
scope是可选字段，但一旦填写就必须精确；留空则默认全局生效（仍需语言 ID 匹配） - React 函数组件常用片段需设为
"scope": "typescriptreact, javascriptreact"，不能只写react（这不是合法 language ID） - Vue 单文件组件中，
<script>块默认是vue语言模式，但脚本内部实际运行在javascript或typescript下，建议同时声明"scope": "javascript, typescript, vue"
预设片段（如 HTML、CSS）无法展开：确认触发方式和前缀是否被覆盖
VSCode 内置的 html、css 片段（如 html:5、flex）需要手动输入前缀再按 Tab，不是自动弹出。如果输完前缀没反应，可能是快捷键冲突或设置屏蔽了 Snippet Suggestion。
- 确保
"editor.suggest.showSnippets"设为true（默认开启，但可能被用户配置覆盖） - 检查是否启用了
"editor.tabCompletion"：设为"on"可用 Tab 补全；设为"onlySnippets"则仅对片段生效；设为false则完全禁用 - 某些插件（如 Auto Rename Tag、Ember Snippets）会劫持
Tab行为，临时禁用插件排查 - HTML 片段如
! + Tab展开html:5，但该快捷仅在html语言模式下有效；在javascript文件里输!不会触发
片段 JSON 格式错误导致全部失效：验证语法与结构层级
一个片段语法错误（如多逗号、引号不闭合、body 缺少数组括号）会导致整个文件的片段加载失败，VSCode 不报错也不提示——这是最隐蔽的“静默失效”原因。
- 片段文件必须是标准 JSON，
body字段值必须是字符串数组，哪怕只有一行也要写成["console.log($1);"]，不能是"console.log($1);" - 变量占位符如
$1、${2:default}必须用英文半角，不能混入中文标点或全角空格 - 路径中不要用
~或环境变量，VSCode 片段路径只认绝对路径或工作区相对路径（推荐用 VSCode 设置界面添加，避免手写路径出错） - 可将片段内容粘贴到 JSONLint 验证格式
{
"log": {
"prefix": "log",
"body": ["console.log($1);"],
"description": "console.log"
}
}
多工作区/远程开发下片段未同步：注意片段作用域优先级
VSCode 支持四种片段作用域：用户级（全局）、工作区级（.vscode/snippets/）、扩展级、语言专属（如 javascript.json）。优先级从高到低，高优先级会覆盖低优先级同名片段。
- 工作区级片段放在
.vscode/snippets/javascript.json，只对该工作区生效；若同时存在用户级javascript.json，工作区版本优先生效 - 远程开发（SSH/Containers）时，本地用户级片段不会自动同步到远程，必须在远程窗口中重新配置，或使用 Settings Sync（注意：Sync 默认不同步 snippets）
- 扩展自带片段（如 ES7+ React/Redux/React-Native Snippets）可能与自定义片段前缀冲突，例如都定义了
rfc，VSCode 会随机选用一个——改前缀或禁用冲突扩展 - 检查当前生效的片段来源：在触发建议列表中，鼠标悬停在片段项上，会显示来源（如
User Snippets、ES7 React Extension）
