新建.sublime-snippet文件需满足三要素：后缀必须为.sublime-snippet，存放于packages/user/目录（通过preferences→browse packages…定位），内容为合法xml且根节点为，包含、和可选。
怎么新建一个 .sublime-snippet 文件
Sublime 的代码片段本质就是一个 XML 格式的 .sublime-snippet 文件，放在特定目录下才能被识别。不是写完保存就行，路径错、后缀名错、XML 格式错，全都不生效。
- 必须用
.sublime-snippet作为后缀（少一个连字符或写成.snippet都不行） - 文件要放在 Sublime 的
Packages/User/目录下（Windows/macOS/Linux 路径不同，但通过 Preferences → Browse Packages… 打开的就是正确位置） - 内容必须是合法 XML，且根节点为
<snippet></snippet>，里面必须包含<content></content>和<tabtrigger></tabtrigger>
示例最小可用片段（保存为 Packages/User/log-js.sublime-snippet）：
<snippet><content></content><tabtrigger>log</tabtrigger><scope>source.js</scope></snippet>
为什么 tabTrigger 不生效
最常见原因是作用域（<scope></scope>）没配对，或者拼写错误。Sublime 不会报错，只是静默忽略——你敲 log + Tab，啥也不发生，还以为是快捷键冲突。
-
<scope></scope>值必须和当前文件的语法定义匹配，比如 JS 文件通常是source.js，React JSX 是source.js.jsx，Vue 单文件组件的 script 块是source.js.embedded.html - 不确定当前作用域？打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），输入View Package File→ 选Syntaxes/JavaScript/JavaScript.sublime-syntax，看顶部scope: source.js那行 - 想全局生效？可以删掉
<scope></scope>，但不推荐——容易在非目标语言里误触发
如何让 snippet 支持多光标和变量跳转
靠 、 这类占位符实现跳转顺序，<p>靠 <code>$1、$2 这类占位符实现跳转顺序，$0 是最终光标停留位。但直接写 $1 不会自动高亮或补全，得用 ${1:default} 格式才带默认值和可编辑框。
${1:default} 格式才带默认值和可编辑框。
-
${1:console}表示第一个跳转位，默认显示console，可编辑；$2后按 Tab 就跳到第二处 -
$0必须出现一次，且只出现一次，代表最后光标位置（比如函数体写完后自动跳到结尾分号后） - 避免用
$1重复多次——它们会同步变化，不是独立字段；真要重复输入，用${1:xxx}+${1}
比如写一个带参数的函数片段：
<content></content>
Python 或 HTML 片段里中文乱码或缩进崩了
XML 解析器对空白敏感，<content></content> 里的换行和缩进会被原样插入。你在编辑器里回车多按了几下，生成的代码就多几行空行或错位缩进。
- 别手动敲回车对齐 XML 标签——把
<content></content>写成单行，用包裹内容，内部换行缩进才不影响输出 - CDATA 里写 Python 时，注意缩进层级：Sublime 默认按当前文件缩进设置插入，但如果你的片段本身含 2 个空格缩进，而文件用 4 个，结果就会错位
- HTML 片段中避免在
<content></content>外层加额外空格或换行，否则可能在标签前插入空格，破坏内联元素布局
乱码通常是因为文件没存成 UTF-8 无 BOM —— 用 Sublime 右下角编码菜单确认是 UTF-8，不是 UTF-8 with BOM 或 GBK。
作用域判断不准、CDATA 换行吃缩进、编码存错——这三个点卡住的人最多，其他都是小调整。
