Sublime Text代码模板需满足三个硬性条件才生效：文件必须存于Packages/User/目录，命名须为xxx.sublime-snippet且无隐藏扩展名，scope必须严格匹配当前文件作用域（如source.js），多scope用英文逗号分隔且不可有空格。
Sublime Text 的代码模板（Snippet）不会自动扫描或热加载——你把文件丢进目录，它不认；改完保存，它也不立刻生效。必须满足三个硬性条件，且路径、后缀、XML结构全对，才可能触发。
文件必须存到 Packages/User/ 目录下
别靠记忆拼路径，也别用资源管理器手动导航。Windows 下常误入 Packages/ 根目录，macOS Finder 默认隐藏 User 文件夹，Linux 用户可能扔进项目目录或插件子目录——这些位置 Sublime 一律不读。
- 正确做法：打开 Sublime → Preferences → Browse Packages… → 直接进入弹出窗口里的
User文件夹 - 在这个目录里新建或粘贴你的
.sublime-snippet文件 - Windows 用户务必在“另存为”对话框中手动输入完整文件名，例如
log-console.sublime-snippet；如果系统隐藏扩展名，实际保存成log-console.sublime-snippet.txt，Sublime 完全无视
<scope></scope> 必须和当前文件真实作用域完全匹配
你在 .js 文件里敲 log + Tab 没反应？90% 是 <scope></scope> 写错了。Sublime 不报错，只是静默跳过。
- 查当前真实作用域：按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac）→ 输入Developer: Show Scope Name→ 看状态栏显示，比如source.js、source.ts.embedded.html、text.html.vue -
<scope></scope>值必须严格对应，不能写javascript或js；合法值包括：source.js、source.python、text.html.basic、source.css - 多个作用域用英文逗号分隔，**不能有空格**：
source.js,source.ts✅｜source.js, source.ts❌ - 临时调试可设为
text.plain，确认 snippet 能触发后再换回精确 scope
<content></content> 里含 HTML/JSX 必须用
直接往 <content></content> 里塞带 、<code>&、" 的代码（比如 Vue 模板或 JSX），XML 解析器会崩，整个 snippet 静默失效。
- 必须用
包裹全部内容，且和 <code>]]>必须顶格写，前后不能有空格或换行 - CDATA 内部不要用 Tab 键缩进——Tab 在 snippet 编辑时会被解释为占位符跳转符，不是空格
- 如需控制缩进，用显式空格或
\t；多行结构每行开头不要留空格，否则插入后代码错位 - 手动清理首尾空行，否则插入后会多出空白行
改完之后怎么确认它真被加载了？
保存文件 ≠ 生效。Sublime 不监听文件系统变化，也不会自动重载 snippet 列表。
- 执行
Ctrl+Shift+P→ 输入Reload Syntax Definitions回车（注意不是 “Reload Snippets”，那个命令不存在） - 或者更直接：切换到另一个 tab，再切回来；或者关闭当前文件重新打开
- 如果仍不生效，检查 XML 是否合法——根节点必须是
<snippet></snippet>，不能漏闭合标签，不能有非法字符
最麻烦的点往往不在逻辑，而在细节：一个没显示的扩展名、一行多余的空格、一个没配对的作用域——它们都不报错，只沉默拒绝执行。
