sublime 的 snippet 文件必须放在 packages/user/ 目录下才能被识别，仅扫描该路径及子目录；命名需语义化、无空格特殊符；tabtrigger 和 scope 共同决定触发时机，scope 必须匹配当前文件语法（如 source.js），支持多 scope 逗号分隔；xml 中需用 ${0} 标记终点光标，修改后须重启或执行 reload syntax definitions 刷新。
snippets 文件必须放在 Packages/User/ 目录下才能被 Sublime 识别
Sublime 不会自动扫描任意路径的 sublime-snippet 文件，只认 Packages/User/ 及其子目录。如果你把片段文件丢在桌面或项目文件夹里，它永远不生效。
实操建议：
- 用菜单 Preferences → Browse Packages… 打开
Packages目录，直接进User文件夹 - 文件名建议用语义化命名，比如
log-console.sublime-snippet，不要用空格或特殊符号 - 如果已有同名 snippet（比如都叫
log），后加载的会覆盖先加载的——Sublime 按目录顺序加载，User是最后加载的，所以放这里最稳妥
snippet XML 结构里 tabTrigger 和 scope 决定触发时机
tabTrigger 是你敲完按 Tab 触发的关键字，scope 则限定它只在特定语法下生效。漏写 scope 就会导致：在 Python 文件里敲 log 触发了 JS 的 console.log()，或者反过来完全不触发。
常见错误现象：
- 敲了 trigger 没反应 → 检查
scope是否匹配当前文件语法（如source.js对应 JavaScript，source.python对应 Python） - 在所有文件都能触发 →
scope写成了text.plain或干脆没写 - 想支持多种语言 → 可以用逗号分隔多个 scope，比如
source.js, source.ts
示例（JS 日志片段）：
<snippet> <content><![CDATA[console.log($1);${0}</content> <tabTrigger>log</tabTrigger> <scope>source.js</scope> <description>console.log()</description> </snippet>变量和占位符用 $1、$2、${0} 控制光标跳转顺序
不是所有编辑器都支持 <p>不是所有编辑器都支持 <code>$0 作为最终光标位置，但 Sublime 必须用它，否则插入后光标停在中间，没法自然继续输入。
作为最终光标位置，但 Sublime 必须用它，否则插入后光标停在中间，没法自然继续输入。
使用场景：
-
$1是第一个跳转位置，$2是第二个……数字越大越后跳 -
${0}是终点，Tab 循环完所有$N后停在这儿；没有它，光标就卡在最后一个$N上不动 - 重复变量用
${1:default}，比如${1:document}，既设默认值又统一跳转
容易踩的坑：写成 $0 而不是 ${0} —— Sublime 会忽略这个占位符，光标行为不可预测。
修改 snippet 后要重启 Sublime 或手动刷新
Sublime 不监听 .sublime-snippet 文件变更，改完保存后不会自动重载。你可能改了十次 trigger 都没生效，其实只是没重启。
实操建议：
- 最可靠的是退出再打开 Sublime
- 快捷方式：按
Ctrl+Shift+P（windows/linux）或Cmd+Shift+P（macos），输入Reload Syntax Definitions回车（注意不是 “Reload Package”） - 如果仍不生效，检查控制台（
Ctrl+`）有没有报错，常见是 XML 格式错误或 scope 拼错
复杂点在于：scope 名称不是文件后缀，而是语法定义里的 scope_name。比如 Markdown 文件实际 scope 是 text.html.markdown，不是 text.md —— 这个得用 Tools → Developer → Show Scope Name 实时看。