Sublime Text 自定义代码片段需手动创建合法 .sublime-snippet 文件并置于 Packages/User 目录，文件须含根节点、content、tabTrigger 和 scope，且 scope 与当前文件语法匹配才能触发。
Sublime Text 的自定义代码片段（Snippets）不是靠“启用插件”或“一键安装”生效的，而是必须手动创建 .sublime-snippet 文件并放在正确路径下，否则无论怎么触发都不会展开。
如何创建一个合法的 Snippet 文件
Snippet 本质是 XML 格式文件，必须包含 <snippet></snippet> 根节点、<content></content> 和 <tabtrigger></tabtrigger>。缺任意一项，Sublime 就会静默忽略该文件。
-
<tabtrigger></tabtrigger>决定你输入什么后按 Tab 触发，比如设为log，输入log再按 Tab 就插入内容 -
<scope></scope>控制生效范围，例如source.python表示只在 Python 文件中响应；不写则全局生效（不推荐） -
$1、$2是光标跳转位置，$0是最终停留点；${1:default}表示带默认值的占位字段
<?xml version="1.0" encoding="UTF-8"?>
<snippet>
<content><![CDATA[
print("${1:message}") # $0 表示最后光标位置
]]></content>
<tabTrigger>log</tabTrigger>
<scope>source.python</scope>
<description>Python print snippet</description>
</snippet>Snippet 文件必须放在 Packages/User 目录下
Sublime 不会扫描任意路径下的 .sublime-snippet 文件。它只从以下两个位置加载：
-
Packages/User/—— 推荐放这里，升级 Sublime 不会丢失 -
Packages/<Package Name>/—— 第三方包目录，不建议手动改
获取 Packages/User 实际路径：菜单栏 Preferences → Browse Packages…，打开后进入 User 文件夹，把上面保存的 log.sublime-snippet 放进去即可。
为什么写了 snippet 却不触发？常见原因
最常踩的坑不是语法错，而是作用域（<scope></scope>）和文件类型不匹配：
- 你在
.js文件里写log+ Tab，但 snippet 的<scope></scope>是source.python→ 不响应 - 没写
<scope></scope>，但当前文件被 Sublime 识别为text.html（比如无后缀或 .txt），而 snippet 默认只对源码类 scope 生效 → 不响应 - 文件实际 syntax 是
Plain Text，不是Python→ 检查右下角状态栏，点击切换 syntax - 文件名含空格或中文，导致 Sublime 加载失败（极少见但存在）→ 改用英文命名
进阶：用 TM_SELECTED_TEXT 插入选中内容
想把选中的文本包裹进模板？比如选中 user_id，按快捷键变成 str(user_id)，需在 <content></content> 中使用 $SELECTION 变量：
<?xml version="1.0" encoding="UTF-8"?> <snippet> <content><![CDATA[ str($SELECTION) ]]></content> <tabTrigger>str</tabTrigger> <scope>source.python</scope> </snippet>
注意：$SELECTION 不支持带默认值的写法（如 ${SELECTION:default}），也不支持多光标编辑联动；如果没选中任何文本，它会插入空字符串。
真正卡住人的从来不是怎么写 XML，而是 scope 是否匹配、Packages/User 路径是否正确、以及当前文件 syntax 是否被识别为你预期的语言。确认这三点，90% 的 snippet 失效问题就解决了。
