Sublime Snippet 是 XML 文件，须存于 Packages/User/ 目录且后缀为 .sublime-snippet；tabTrigger 定义触发关键词，scope 指定生效语法范围，$1、$2 为可编辑占位符，$0 为最终光标位置且必须唯一。

如何创建并触发一个 Sublime Snippet 文件

Sublime 的代码片段本质是 XML 文件，必须放在 Packages/User/ 目录下，后缀为 .sublime-snippet。不放对位置或命名错误，Ctrl+Shift+P 里搜不到、Tab 也触发不了。

• 用 Preferences → Browse Packages… 打开目录，进入 User 文件夹
• 新建文件，例如 log-js.sublime-snippet，内容按标准 XML 结构写
• tabTrigger 决定触发关键词（如输入 log 后按 Tab），不能含空格或特殊字符
• scope 指定生效范围，比如 source.js 表示只在 JavaScript 文件中可用

<snippet><content></content><tabtrigger>log</tabtrigger><scope>source.js</scope><description>console.log() with cursor at $1</description></snippet>

Snippet 中的 $1、$0、$2 是什么含义

这些是占位符（tab stop），控制光标跳转顺序和编辑焦点。$1 是第一个停靠点，$2 是第二个，$0 是最终光标位置（常用于收尾）。如果漏写 $0，回车或 Tab 多次后光标会消失在片段外，容易误操作。

• $1 和 $2 可重复出现，比如 function $1() { $0 } 中，$1 出现两次就可同步修改函数名
• $0 必须有且只能有一个，它代表“退出片段编辑态”的终点
• 若想插入实际美元符号，得写成 \$，否则会被当成占位符解析

为什么写了 snippet 却无法通过 Tab 触发

最常见原因是作用域（scope）不匹配。Sublime 根据当前文件语法高亮类型决定启用哪些 snippet，比如你在 .html 文件里写了 scope="source.js"，这个 snippet 就根本不会加载。

魔乐社区

魔乐社区是一款面向人工智能开发者的模型、数据、工具和应用协同社区。

下载

• 查当前文件 scope：按 Ctrl+Shift+P → 输入 Scope: Show Scope，看顶部状态栏显示的内容（如 text.html.basic）
• 多个 scope 用逗号分隔，例如 source.js, source.jsx
• 临时测试可先设成 text.plain，确认能触发后再收紧 scope
• 注意大小写敏感，source.python ≠ source.Python

如何复用已有代码块快速生成 snippet

不用从头写 XML —— 选中一段代码，按 Ctrl+Shift+P 输入 Convert to Snippet，Sublime 会自动生成基础结构，你只需补全 tabTrigger 和 scope。

• 选中的内容自动成为 ，但变量部分需手动替换为 $1、$2 等
• 如果原代码含缩进，XML 里会保留空格，建议用空格对齐而非 Tab，避免缩进错乱
• 生成的文件默认无 scope，务必加上，否则只在纯文本里生效

复杂逻辑（比如带条件判断的模板）不适合用 snippet 实现，它不支持运行时计算，只是静态文本替换。真需要动态生成，得换插件或外部工具。