sublime text 的 snippet 需同时满足三条件才生效：.sublime-snippet 后缀、存于 packages/user/ 目录、内容为合法 xml 且根节点为 ；作用域不匹配、编码错误、路径错误或 cdata 缺失均导致静默失效。
Sublime Text 的 Snippet 不是“写完就生效”的功能，它对文件位置、XML 结构、作用域匹配和编码细节极其敏感——漏掉一个 CDATA 或存错目录，就完全不触发，且不报错。
如何确认 snippet 文件被 Sublime 正确加载
文件必须同时满足三个硬性条件：.sublime-snippet 后缀、保存在 Packages/User/ 目录下、内容是合法 XML 且根节点为 <snippet></snippet>。常见失效场景包括：
- Windows 下默认隐藏扩展名，实际保存成了
log.sublime-snippet.txt（Sublime 完全无视） - 用记事本等编辑器保存时未设 UTF-8 编码，含中文或特殊字符导致解析失败
- 通过
File → Save As…误存到桌面或Packages/Default/等非User目录
验证方式：改完后按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（Mac），输入 Reload Syntax Definitions 回车，强制刷新 snippet 列表。
为什么 tabTrigger 输入后没反应
最常见原因是 <scope></scope> 值与当前文件语法不匹配。Sublime 不会提示错误，只是静默跳过——你敲 log + Tab，光标不动，不是快捷键冲突，是 scope 没对上。
- 查当前作用域：按
Ctrl+Shift+P→ 输入Show Scope Name回车，状态栏显示类似source.js.embedded.html或text.html.basic的字符串，取最前面那段（如source.js）填进<scope></scope> - 右下角语法标识显示
Plain text却写了<scope>source.js</scope>？那 snippet 根本不会激活 - 想全局生效可删掉
<scope></scope>标签，但容易和 Emmet 或其他 snippet 冲突，慎用
<content></content> 中的换行缩进怎么控制才不破坏代码结构
<content></content> 内容会被原样插入，包括换行和空格。如果写成：
<content></content>
实际插入时会在开头多一个换行，且缩进会被保留——这在函数体内触发时容易破坏对齐。
- 更稳妥的做法是把
放在行首，内容紧贴其后，结尾的 <code>]]>也顶格写 - 避免在
CDATA内部用 Tab 键缩进（Tab 在 snippet 编辑时会被解释为占位符跳转符） - 如需多行结构（如
if块），每行开头不要空格，用显式空格或\t控制缩进逻辑 - 手动清理首尾空行，否则插入后会多出空白行
$1、${1:default} 和 $0 的行为差异
$1 是第一个可编辑位置，按 Tab 跳到 $2，再按跳到 $0（最终停留位）。这是最轻量、最稳定的做法。
-
${1:console.log}可设默认值，但注意：一旦用户修改了这个字段，后续$2的位置可能偏移（尤其在多行模板中） -
$0仅可出现一次，它是光标最终停靠点，不是跳转位 - 同步修改同一变量用
${1:className}，它在多个位置出现时首次输入后其余位置自动更新 - 嵌套占位如
${2:${1:defaultValue}}表示第 2 个位置默认取第 1 个位置的值，但复杂逻辑建议拆分为简单跳转，避免调试困难
真正容易被忽略的是：所有这些变量行为都依赖于 <content></content> 被正确包裹在 中——漏掉它，整个 snippet 就静默失效，连报错都不会有。
