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} 控制光标跳转顺序

不是所有编辑器都支持 $0 作为最终光标位置，但 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 实时看。