sublime的snippet是光标处插入结构化代码块的轻量机制，非批量建文件工具；需满足路径在packages/user/、scope匹配当前语法、xml格式正确（含cdata包裹）三者缺一不可。
Sublime 的 snippet 不是“一键生成 N 个文件”的工具，而是“在光标处精准插入结构化代码块”的轻量机制。它生效快、不依赖插件、无运行时开销——但前提是路径、scope、XML 格式三者全对，缺一不可。
Snippet 文件必须放在 Packages/User/ 目录下
Sublime 只扫描这个固定路径下的 .sublime-snippet 文件。放错位置（比如桌面、项目根目录、Packages/JavaScript/）等于没写。
- Windows：打开
%APPDATA%\Sublime Text\Packages\User\ - macOS：用
Preferences → Browse Packages…直接跳转 - Linux：
~/.config/sublime-text/Packages/User/ - 别用中文路径或带空格的文件名——部分 Sublime Text 4 版本会静默跳过加载
scope 写错 = 完全没反应
底部状态栏显示的是 Plain text 或 HTML (Twig)，而你的 snippet 写了 <scope>source.js</scope>？那输再多遍 log + Tab 都不会展开。
- 检查当前文件语法：右键编辑区 →
Set Syntax→ 选对语言（如JavaScript） - 常用 scope 值：
source.js、source.jsx、text.html.basic、source.css - 多个 scope 用逗号分隔，逗号后不能有空格：
source.js, source.ts✅｜source.js, source.ts❌ - 删掉
<scope></scope>标签可全局生效，但容易和 Emmet 或其他 snippet 冲突，慎用
<content></content> 必须用
不加 CDATA，XML 解析器遇到 {、 就直接报错跳过加载，且不提示任何错误信息——你只会觉得“怎么不生效”。
- 占位符用
$1、$2，不是${1:default}；后者只在需要默认值时才加，过度使用反而让跳转逻辑变复杂 - 缩进会被原样插入：想顶格写就顶格，想缩进两格就手动敲两个空格——别用 Tab 键，它在 snippet 编辑中是跳转符
- 换行符也原样保留，所以
\n展开后就是带换行的结构
触发词输完按 Tab 没反应？先查这三件事
不是 Sublime 坏了，90% 是配置问题。
-
tabTrigger值只能含字母、数字、下划线，比如http-get❌｜http_get✅ - 文件名建议和
tabTrigger一致（如触发词为myhtml5，文件就叫myhtml5.sublime-snippet），避免混淆 - 改完 snippet 后，执行
Ctrl+Shift+P→ 输入Reload Syntaxes刷新，不用重启编辑器 - 如果仍无效，打开控制台（
Ctrl+`）看有没有 XML parse error 提示
最常被忽略的一点：snippet 的本质是“文本插入”，不是“逻辑执行”。它不读取变量、不调 API、不渲染模板。想批量建文件？得用 Python 插件或 SublimeTmpl；想动态注入当前时间或用户名？得靠外部模板引擎配合 shell 脚本——Sublime 自身不提供这些能力。
