VSCode代码片段前缀匹配需同时满足语言模式一致、输入完全等于prefix且光标位于行首或空白后；常见失效因配置文件位置错误、语言ID不匹配、body非字符串数组或缺失$0。
前缀匹配不等于“输入就触发”
VSCode 的 prefix 字段只是触发候选列表的入口，不是按下任意键就自动插入。必须满足三个条件才出现在补全提示里：当前编辑器语言模式（如 javascript）与片段配置文件名或 scope 字段一致；输入内容**完全等于**该 prefix 字符串（不区分大小写）；且光标位于行首或空白字符后（不能卡在单词中间）。比如你定义了 "prefix": "log"，但在 mylog 里输完 log，它不会弹出——因为不是独立词。
为什么写了 prefix 却没反应？常见失效场景
最常踩的坑是配置文件放错位置或语言 ID 不对：
- 手动创建
.vscode/snippets/目录并扔 JSON 文件进去 —— VSCode 不认，必须通过命令面板执行Preferences: Configure User Snippets打开对应语言文件 - 给 JavaScript 写片段却保存为
js.json—— 正确文件名是javascript.json（VSCode 用的是语言 ID，不是文件扩展名） -
body写成字符串而非字符串数组 —— 比如"body": "console.log('$1');"是错的，必须是"body": ["console.log('$1');"] - 漏掉
$0或所有占位符被填满后光标无处可落 —— 虽不影响触发，但会导致插入后无法继续编辑，建议结尾加$0
多个同名 prefix 怎么共存？优先级怎么算
如果两个片段都设了 "prefix": "log"，VSCode 会把它们一起列在补全菜单里，靠上下键选择。但谁排前面、谁最终生效，取决于优先级顺序：
- 用户级片段（即通过
Configure User Snippets创建的）优先级最高 - 工作区级片段（放在
.vscode/snippets/下的）次之 - 插件自带的片段优先级最低
注意：同级配置中，后加载的会覆盖先加载的，但 VSCode 不保证加载顺序，所以不要依赖“谁写在前面谁生效”。真要避免冲突，就改 prefix，比如一个用 log，另一个用 logd。
想让前缀更灵活？别只靠 prefix 字段
prefix 本身不支持正则或模糊匹配，但可以通过组合其他字段增强实用性：
- 用
scope限定仅在特定语言或语法区域生效，例如"scope": "javascript,typescript" - 配合变量实现动态内容，比如
${CURRENT_YEAR}插入年份，$TM_FILENAME插入文件名，避免硬编码 - 长前缀更容易避免误触，比如
"prefix": "clog"比"log"更少和日常单词冲突 - 如果需要上下文感知（比如只在 React 组件里触发），得靠插件或自定义语言服务器，纯 snippet 做不到
真正容易被忽略的是：VSCode 对 prefix 的匹配发生在「输入完成 + Tab/Enter」那一刻，而不是实时监听。这意味着你没法靠它做类似 IDE 的语义补全，它本质是个静态模板快捷键——别指望它理解你正在写的函数名或变量作用域。
