Sublime Text 的代码片段必须使用 .sublime-snippet 后缀、存于 Packages/User/ 目录、全英文路径、UTF-8 无 BOM 编码，且需重启生效；tabTrigger 定义触发缩写，scope 限定语法环境，变量用 $1、${2:default} 格式。
Snippets 文件必须用 .sublime-snippet 后缀
Sublime Text 不会识别 .xml、.txt 或无后缀的文件为代码块。新建文件后，务必保存为 xxx.sublime-snippet，否则即使内容正确也不会出现在补全列表中。
常见错误是直接复制别人 snippet 内容到普通文本文件里改完就关，结果重启 Sublime 也看不到效果。路径建议放在：Packages/User/ 目录下（可通过菜单 Preferences → Browse Packages… 打开）。
tabTrigger 和 scope 决定触发时机
tabTrigger 是你敲完按 Tab 键时激活 snippet 的缩写词，比如设为 log，输入 log 再按 Tab 就展开；scope 控制它在哪些语法下生效——这点极易被忽略。
例如 JavaScript 中常用的 console.log();，如果 scope 写成 source.python，那在 JS 文件里永远触发不了。常用 scope 值有：
-
source.js（JS 文件） -
source.python（Python 文件） -
text.html.basic（HTML 文件） -
source.css（CSS 文件）
查当前文件 scope：按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Scope: Show Scope Name 回车，底部状态栏会显示当前光标处的完整 scope 字符串。
变量和占位符用 $1、$2、${1:default} 格式
Snippets 支持多光标跳转和默认值，但语法不是 ${var} 或 $name 这类模板写法，而是严格使用数字序号加可选默认值：
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
-
$1表示第一个跳转位置，按 Tab 可依次移动 -
${1:document}表示此处默认填document，可直接编辑 -
${2:selector}是第二个跳转点，常用于函数参数或 CSS 选择器
错误示例：$myVar 或 ${foo} —— Sublime 会原样输出，不解析也不跳转。
一个实用的 JS snippet 片段：
<snippet>
<content><![CDATA[
console.log('${1:msg}', ${2:obj});
$0
]]></content>
<tabTrigger>clg</tabTrigger>
<scope>source.js</scope>
<description>console.log with two args</description>
</snippet>
中文路径或特殊字符可能让 snippet 加载失败
如果你把 .sublime-snippet 文件放在含中文、空格或符号（如 【】、&）的路径下，Sublime 可能静默跳过加载——不会报错，但就是不出现。
解决办法只有两个：
- 确保文件路径全英文、无空格（如
Packages/User/js-log.sublime-snippet） - 重启 Sublime Text（修改或新增 snippet 后必须重启才生效，仅刷新菜单不够）
另外，文件编码必须是 UTF-8 无 BOM，用 VS Code 或 Sublime 自身另存时注意勾选该选项。BOM 头会导致解析失败，现象是 snippet 完全不可见。
