sublime text代码片段需同时满足后缀为.sublime-snippet、存于packages/user/、内容为合法xml且根节点为，三者缺一即静默失效；scope匹配与cdata顶格书写同样关键。
Sublime Text 的代码片段不是“保存就生效”，它对文件位置、XML 结构、scope 匹配和编码细节四者全部敏感——错一个，就静默失效，且不报错。
怎么确认 snippet 文件被 Sublime 正确加载
文件必须同时满足三个硬性条件：后缀是 .sublime-snippet（不能是 .snippet、.xml 或隐藏的 .txt），路径在 Packages/User/（通过 Preferences → Browse Packages… 打开的就是正确位置），内容是合法 XML 且根节点为 <snippet></snippet>。
- Windows 下常因“隐藏已知文件扩展名”导致实际保存为
log.sublime-snippet.txt——Sublime 完全无视 - 手动新建文本再改名时，若编辑器未设 UTF-8 编码，含中文或特殊字符会解析失败
- 用
File → Save As…却选错目录（比如存到桌面或Packages/Default/）会导致加载失败 - 验证方式：保存后按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入Reload Syntax Definitions回车，强制刷新 snippet 列表
为什么 tabTrigger 按了没反应
90% 的失效源于 scope 不匹配。Sublime 不看文件后缀，只认当前光标处的语法作用域（syntax scope）。
- 先确认右下角显示的语法名，比如
JavaScript，不是JSX或Vue Component——后者需额外配置scope -
tabTrigger必须拼写完全一致，且不能含空格或点号：log可以，console.log不行（会被当作文本字面量处理） - Vue 单文件组件的
<script></script>块真实 scope 是source.vue meta.script.js，不是source.js - 查真实 scope 的方法：打开对应文件 →
Ctrl+Shift+P→ 输入Developer: Show Scope Name→ 状态栏显示的就是完整 scope 链
content 里写代码总出错或格式乱
<content></content> 中的内容必须用 顶格包裹，否则 、<code>{、$ 等符号会被 XML 解析器截断或报错。
- CDATA 必须顶格写：
，不能缩进或换行开头 - 多行模板中首尾空行要手动清理，否则插入时带多余换行，破坏代码对齐
- 占位符
$1、$2必须连续编号，断号（如只有$1和$3）会导致跳转失效 -
$0是最终光标出口，必须有且只能出现一次；漏写就卡在最后一个$N - 想输出字面量
${date}，得写成\${date}，否则 Sublime 尝试解析变量并可能跳过整段
多个 snippet 冲突或触发旧内容
Sublime 不提示冲突，而是静默采用「最后修改时间最新」的那个 tabTrigger 相同的文件。
- 明明刚保存了新 snippet，按 Tab 却插入旧内容 → 搜索
Packages/User/下所有含<tabtrigger>log</tabtrigger>的文件，删掉过期项 - 删除了一个 snippet 文件，
tabTrigger还能触发 → 说明还有另一个同名 trigger 潜伏着 - 临时排查法：把疑似冲突的其他 snippet 重命名为
xxx_bak.sublime-snippet，再测试 - 文件名建议全英文小写 + 连字符，如
log-js.sublime-snippet；中文命名在部分 ST4 版本中加载失败
最隐蔽的坑是 scope 和 CDATA 的组合问题：scope 对了但 CDATA 没顶格，插入内容就缺一半；CDATA 对了但 scope 错成 javascript 而非 source.js，它就在 JS 文件里彻底隐身——两者都得对，缺一不可。
