Sublime Text 的 Snippets 文件必须命名为 .sublime-snippet 后缀的 XML 文件，存放于对应系统 User 包路径下，且文件名避免中文与空格；tabTrigger 须符合大小写敏感、无特殊字符等规则；scope 必须使用合法语法作用域（如 source.js），而非语言简称；占位符 $1、$2 等按 XML 中出现顺序决定跳转位置，重复编号仅保留首个。
Snippets 文件怎么命名才生效
Sublime Text 只认 .sublime-snippet 后缀的 XML 文件，名字随便起，但后缀错一个字母（比如 .snippet 或 .sublime-snippet.xml）就完全不加载。文件必须放在正确路径下：Windows 是 %APPDATA%\Sublime Text\Packages\User\，macOS 是 ~/Library/Application Support/Sublime Text/Packages/User/，Linux 是 ~/.config/sublime-text/Packages/User/。
- 别用中文或空格命名文件，容易在某些系统上触发编码或路径解析问题
- 如果改了文件内容但没生效，不是缓存问题——Sublime 不缓存 Snippets，是文件没放对位置或后缀错了
- 重启 Sublime 不必要，保存文件后自动重载，但新文件要等下次启动才识别（这是 Sublime 的设计）
tabTrigger 写错就无法触发
tabTrigger 是你按 Tab 键唤出代码块的关键字，它不支持通配符、正则，也不能含点号（.）、斜杠（/）或空格。比如想写 console.log 片段，tabTrigger 只能设成 log 或 clog，不能是 console.log —— 否则 Sublime 直接忽略整个 snippet。
- 多个 snippet 用了相同
tabTrigger，只有最后一个加载的生效（按文件名 ASCII 排序，不是按修改时间） -
tabTrigger区分大小写，Log和log是两个触发词 - 如果输入后按 Tab 没反应，先检查控制台（
Ctrl+`）有没有报error loading snippet类错误
scope 决定片段在哪种文件里可用
scope 值不是随便写的语言名，而是 Sublime 内部的语法作用域（syntax scope），比如 JavaScript 是 source.js，Python 是 source.python，Vue 单文件组件的 script 块是 source.js.embedded.html。写错 scope，片段就“隐身”——即使触发词对、文件位置对，也根本不会出现。
- 快速查当前文件的 scope：按
Ctrl+Shift+P→ 输入Developer: Show Scope Name，光标所在位置的作用域会显示在状态栏 - 想让片段在多种语言中生效，可以用逗号分隔多个 scope，例如
source.js, source.ts, source.jsx - 别写成
javascript或js，这些不是合法 scope，Sublime 不识别
变量和占位符怎么避免光标跳错位
Snippet 里的 $1、$2 是光标停靠点，$0 是最终退出位置。但很多人误以为数字越大越靠后——其实顺序只由你在 XML 里写的先后决定，$2 出现在 $1 前面，光标就会先停 $2。更隐蔽的问题是嵌套结构：比如在 ${1:foo} 里又写 $2，Sublime 会把它当独立占位符处理，导致跳位混乱。
- 简单逻辑用
$1、$2、$0足够；复杂模板优先用${1:default}格式，避免裸数字冲突 - 不要在同一个 snippet 中重复使用同一编号（如两个
$1），Sublime 只保留第一个 - 如果 Tab 跳过某个占位符，大概率是 XML 里该位置被注释、换行或空格干扰了语法解析
scope 和 tabTrigger 是最常卡住人的两个点，改完 snippet 文件后第一反应不该是“是不是没生效”，而是打开控制台看有没有加载错误，再用 Show Scope Name 确认当前上下文是否匹配。
