合法的 .sublime-snippet 文件是格式严格的 xml，需以 .sublime-snippet 为后缀存于 packages/user/，含正确闭合的 、（无空格）、（如 source.js），支持 $1、$0、$tm_filename_base 等变量，且 必须顶格书写以防缩进错误。
怎么写一个合法的 .sublime-snippet 文件
Sublime 的代码片段本质是 XML 文件，不是 json 也不是 YAML，格式错一个标签就完全不生效。最常踩的坑是没闭合 <content></content> 或漏了 <tabtrigger></tabtrigger> —— 这时候按触发词毫无反应，连报错都没有。
实操建议：
- 文件必须以
.sublime-snippet为后缀，放在Packages/User/目录下（用Preferences → Browse Packages…打开） -
<content></content>里的内容会被原样插入，但支持$1、$2表示跳转位，${1:default}表示带默认值的占位符 -
<tabtrigger></tabtrigger>内容不能含空格或特殊符号，比如log console会失效，得写成logc -
<scope></scope>决定在什么语法下生效，比如source.js对应 JavaScript，text.html.basic对应 HTML；填错就触发不了
tabTrigger 不生效的常见原因
输完触发词按 Tab 没反应？大概率不是 Sublime 坏了，而是 snippet 没被识别或作用域不匹配。
常见错误现象：
- 文件名拼错，比如写成
console-log.sublime-snippet.txt（系统隐藏扩展名时容易中招） -
<scope></scope>写成了javascript，但实际语法名是source.js（查法：打开一个 JS 文件 →View → Syntax → Open all with current extension as…看菜单里显示的名称） - 多个 snippet 共享同一个
<tabtrigger></tabtrigger>，Sublime 只加载最后一个（按文件名 ASCII 排序），不会合并或提示冲突 - 当前文件没有设置语法类型（右下角显示 “Plain Text”），此时
<scope></scope>完全不匹配
如何让 snippet 支持多光标和动态内容
纯静态文本太死板，真正省时间的是能联动变化的部分，比如自动补全函数名+参数+注释结构。
实操要点：
- 用
$0标记最终光标位置，避免插完还得手动移到末尾 - 重复字段用
$1同步，比如function $1() { $0 }，改第一个$1，第二个也跟着变 - 想插入当前文件名？用
$TM_FILENAME_BASE；当前行号？$LINE_NUMBER；这些是 Sublime 内置变量，不是自己定义的 - 注意：变量只在
<content></content>里生效，<tabtrigger></tabtrigger>和<description></description>里不解析
Python snippet 中缩进错乱怎么办
Python 对缩进敏感，但 snippet 的 XML 本身有换行和缩进，一不小心就插进去一堆空格或制表符，导致语法错误。
关键处理方式：
-
<content></content>标签必须顶格写，内部内容首行不能缩进，否则空格会被当作文本插入 - 如果内容本身需要缩进（比如函数体），用
- 写完保存后，用
Ctrl+Shift+P → Insert Snippet手动调用测试，比盲敲tabTrigger更容易发现缩进问题 - 实在不确定，先写最简版本：比如
print($1)$0，确认能跑通再加缩进逻辑
最麻烦的其实是 scope 判断和变量作用域——XML 里看不见逻辑，出问题只能靠试、删、重命名、重启 Sublime。别信“一次写对”，多建几个小文件单独测比堆在一个大文件里强。