sublime-snippet文件需同时满足后缀为.sublime-snippet、存于packages/user/目录、xml结构合法、scope精确匹配四条件才生效;应通过tools→developer→new snippet…生成模板,仅修改内代码、和,cdata须顶格书写且不换行缩进。

sublime-snippet 文件不是“写完就用”,它必须同时满足四个硬性条件:正确后缀、正确路径、合法 XML 结构、精确的 scope 匹配——缺一即静默失效,且 Sublime 不报错、不提示。
如何创建一个能生效的 .sublime-snippet 文件
别手动生成 XML,直接走 Tools → Developer → New Snippet…,它会给你一个带 <snippet></snippet> 根节点和 容器的模板。关键点:
- <content></content> 里所有代码必须包在 中,否则换行、&、 全被 XML 解析器吃掉或报错<br>
- <code><tabtrigger></tabtrigger> 只能是纯字母数字,比如 log 合法,console.log 会被当作文本字面量,按 Tab 没反应
- 文件名必须是 xxx.sublime-snippet(注意不是 .snippet 或 .xml),Windows 用户尤其要关掉“隐藏已知文件扩展名”,否则极易存成 log.sublime-snippet.txt
- 编码必须为 UTF-8(无 BOM),中文路径或含中文文件名会导致加载失败
为什么输入 tabTrigger 后按 Tab 没反应
90% 的问题出在 scope 不匹配。Sublime 不看文件后缀,只认当前光标处的语法作用域。
- 在 .vue 文件的 <script></script> 块里写 JS,scope 写 source.js 是无效的,实际要用 source.vue meta.script.js
- 查当前作用域:按 Ctrl+Shift+P(Win/Linux)或 Cmd+Shift+P(macOS),输入 show_scope_name 回车,状态栏显示的字符串(如 source.js meta.function.js)取最前面一段即可
- 如果不确定,可临时把 <scope></scope> 删掉或设为 text.plain 测试是否加载成功;确认生效后再细化 scope
- 多个 snippet 设了相同 <tabtrigger></tabtrigger>,Sublime 会静默采用「最后修改」的那个文件,删旧文件前务必先搜一遍 Packages/User/ 目录下所有含该 trigger 的文件
怎么让光标自动跳转并填默认值
$1、$2 这些变量只在 <content></content> 的 CDATA 区域内有效,且必须处于顶层文本流中(不能被 XML 标签包裹)。
- ${1:console} 表示第一个跳转位,默认显示 console,光标停在上面可直接编辑
- $0 必须且只能出现一次,代表最终光标位置(比如函数末尾分号后)
- 多个 $1 会同步变化;若需复用同一值但不联动,写成 ${1:xxx} + ${1}
- 函数定义带括号时,写成 function ${1:name}() { $2 },避免 () 被误解析为 XML 标签
- 插入当前文件名用 $TM_FILENAME_BASE,日期用 $CURRENT_YEAR-$CURRENT_MONTH-$CURRENT_DATE
修改 snippet 后为什么还是旧内容
Sublime 不会自动重载已缓存的 snippet,尤其当你在同类型文件(如多个 .js tab)中测试时。
- 保存后执行 Ctrl+Shift+P → 输入 Reload Snippets 回车,强制刷新
- 或者关闭所有同类型文件 tab,再重新打开
- 如果改完仍触发旧内容,说明存在同名 tabTrigger 的其他 snippet,检查 Packages/User/ 下所有文件的修改时间,删掉过期副本
- 注意:Reload Syntaxes 是刷新语法高亮,Reload Snippets 才是刷新代码片段,两者不能混用
scope 不是猜出来的,是查出来的;sublime-snippet 不是“写了就行”,而是“全对才动”。最容易被忽略的是 Windows 下的扩展名隐藏和 Vue/TSX 等复合语法的实际作用域链。











