sublime snippet 文件必须用 .sublime-snippet 后缀且包含完整 xml 结构，含 和 标签，内容需用 cdata 包裹，作用域须准确匹配，修改后可 reload syntax definitions 刷新。
Snippets 文件必须用 .sublime-snippet 后缀
Sublime 不会识别 .xml 或 .txt 后缀的片段文件，哪怕内容完全正确。新建文件后务必手动改名为 xxx.sublime-snippet，Windows 资源管理器默认隐藏扩展名，容易误存为 xxx.sublime-snippet.txt——这种文件会被彻底忽略。
推荐做法：在 Sublime 里用 File → New File，然后 File → Save As…，输入完整名称如 log-console.sublime-snippet，保存到 Packages/User/ 目录下（可通过 Preferences → Browse Packages… 快速打开）。
XML 结构不能省略 content 和 tabTrigger
最简可用 Snippet 必须包含 <content></content> 和 <tabtrigger></tabtrigger> 两个标签，缺一不可。漏掉 <tabtrigger></tabtrigger> 就没法触发；漏掉 <content></content> 则插入空内容，看起来像“没生效”。
常见错误写法：把 JS 代码直接贴进去不包 ，导致 、<code>& 等符号被 XML 解析器吃掉或报错。
正确结构示例：
<snippet> <content><![CDATA[console.log($1); $0]]></content> <tabTrigger>log</tabTrigger> <scope>source.js</scope> </snippet>
-
$1是第一个跳转位，$0是最终光标位置 -
<scope>source.js</scope>控制只在 JS 文件中生效；不加则全局可用 - 作用域名必须准确，比如 Python 是
source.python，CSS 是source.css，可通过Tools → Developer → Show Scope Name实时查看当前光标处的作用域
变量和跳转位在多行内容里容易错位
写多行模板（比如 React 函数组件）时，缩进和换行符会直接影响插入后的格式。Sublime 默认把 <content></content> 中的换行和空格原样输出，但如果你在 XML 里为了可读性把内容缩进，这些空格就会变成实际插入的前导空格。
解决方法只有两个：
- 把整个
<content></content>写在同一行（难读但可靠） - 用
包裹，并确保首行换行和末行换行都删掉，例如：
<content><![CDATA[const $1 = () => {<span></span> return <div>$2</div>; };$0]]></content>
注意：<span></span> 是 hack 写法，用来避免首行缩进被解析——它本身不会输出，但能打断 XML 缩进逻辑。更稳妥的方式是用工具自动生成（如在线 snippet 格式化器），手动调太容易翻车。
修改后不生效？先检查作用域和缓存
改完 Snippet 文件保存后没反应，大概率不是语法错，而是：
- 作用域不匹配：比如在
.vue单文件组件的<script></script>块里写 JS，作用域其实是source.js.embedded.html，不是单纯的source.js - Sublime 没重载：修改
.sublime-snippet文件后无需重启，但有时缓存会卡住，可尝试Ctrl+Shift+P→ 输入Reload Syntax Definitions手动刷新 - 触发词冲突：已有其他插件或内置 snippet 占用了相同
<tabtrigger></tabtrigger>，比如for在很多语言里已被占用，建议加前缀如fori、logc
真正麻烦的是嵌套作用域和动态语法高亮场景——比如 Markdown 里的代码块、Jinja 模板中的 JS 片段，作用域链可能很长，得靠 Show Scope Name 逐层点查，别猜。