新建.sublime-snippet文件需满足三要素：后缀必须为.sublime-snippet，存放于Packages/User/目录（通过Preferences→Browse Packages…定位），内容为合法XML且根节点为<snippet>，包含<content>、<tabTrigger>和可选<scope>。

怎么新建一个 .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><![CDATA[console.log($1);]]></content>
  <tabTrigger>log</tabTrigger>
  <scope>source.js</scope>
</snippet>

为什么 tabTrigger 不生效

最常见原因是作用域（<scope>）没配对，或者拼写错误。Sublime 不会报错，只是静默忽略——你敲 log + Tab，啥也不发生，还以为是快捷键冲突。

• <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>，但不推荐——容易在非目标语言里误触发

如何让 snippet 支持多光标和变量跳转

靠 $1、$2 这类占位符实现跳转顺序，$0 是最终光标停留位。但直接写 $1 不会自动高亮或补全，得用 ${1:default} 格式才带默认值和可编辑框。

• ${1:console} 表示第一个跳转位，默认显示 console，可编辑；$2 后按 Tab 就跳到第二处
• $0 必须出现一次，且只出现一次，代表最后光标位置（比如函数体写完后自动跳到结尾分号后）
• 避免用 $1 重复多次——它们会同步变化，不是独立字段；真要重复输入，用 ${1:xxx} + ${1}

比如写一个带参数的函数片段：

<content><![CDATA[function ${1:name}(${2:args}) {
  $0
}</content>

Python 或 HTML 片段里中文乱码或缩进崩了

XML 解析器对空白敏感，<content> 里的换行和缩进会被原样插入。你在编辑器里回车多按了几下，生成的代码就多几行空行或错位缩进。

• 别手动敲回车对齐 XML 标签——把 <content> 写成单行，用 包裹内容，内部换行缩进才不影响输出
• CDATA 里写 Python 时，注意缩进层级：Sublime 默认按当前文件缩进设置插入，但如果你的片段本身含 2 个空格缩进，而文件用 4 个，结果就会错位
• HTML 片段中避免在 <content> 外层加额外空格或换行，否则可能在标签前插入空格，破坏内联元素布局

乱码通常是因为文件没存成 UTF-8 无 BOM —— 用 Sublime 右下角编码菜单确认是 UTF-8，不是 UTF-8 with BOM 或 GBK。

作用域判断不准、CDATA 换行吃缩进、编码存错——这三个点卡住的人最多，其他都是小调整。