sublime text自定义snippets生效需同时满足三个硬性条件：文件后缀必须为.sublime-snippet、必须存于packages/user/目录、须与当前文件真实语法作用域严格匹配，缺一则静默失效。
Sublime Text 的自定义 Snippets 不是“写完就能用”，它卡在三个硬性条件上：文件名后缀必须是 .sublime-snippet、路径必须在 Packages/User/、<scope></scope> 必须和当前文件真实语法作用域完全匹配——三者缺一，就静默失效，不报错也不提示。
文件存哪儿？别信路径记忆，用菜单打开
你手动拼的路径（比如 %APPDATA%\Sublime Text\Packages\User\ 或 ~/Library/Application Support/Sublime Text/Packages/User/）很容易进错目录。Windows 下常误入 Packages 根目录而非其子目录 User；macOS Finder 默认隐藏 User 文件夹；Linux 用户可能把文件扔进项目目录或 Packages/MyPlugin/ ——这些位置 Sublime 一律不扫描。
唯一可靠做法：
→ 打开 Sublime Text
→ 菜单栏点击 Preferences → Browse Packages…
→ 直接进入弹出窗口里的 User 文件夹
→ 在这里新建或粘贴你的 .sublime-snippet 文件
- 保存时务必在
Save As…对话框中手动输入完整文件名，如log-console.sublime-snippet（不是log.snippet，也不是log-console.xml） - Windows 用户特别注意：资源管理器默认隐藏扩展名，
log-console.sublime-snippet.txt这种文件 Sublime 完全无视 - 改完保存，无需重启 Sublime；但若已打开同类型文件（如正在编辑
.js），建议切换 tab 再切回来，或执行Ctrl+Shift+P→ 输入Reload Snippets
<scope></scope> 写不对，Snippet 就只在纯文本里生效
没写 <scope></scope>，或者写成 javascript、html 这类通俗名，Snippet 就只能在右下角显示 Plain text 的文件里触发。你在 .js 文件里敲 log + Tab 却没反应，90% 是 scope 没配对。
查当前真实 scope 的最快方式：
→ 在目标文件中按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（Mac）
→ 输入并执行 Developer: Show Scope Name
→ 看状态栏显示的内容，例如：source.js、source.ts.embedded.html、text.html.basic、source.python
- 常见合法 scope 值：
source.js、source.ts、source.python、source.css、text.html.basic、text.html.vue - 多个 scope 用英文逗号分隔，**不能有空格**：
source.js,source.ts✅｜source.js, source.ts❌ - 临时调试可设为
text.plain，确认 snippet 能触发后再换回精确 scope
<content></content> 里写 JS/HTML 代码，必须套
直接把带 、<code>&、" 的代码（比如 HTML 模板或 JSX）塞进 <content></content> 标签，XML 解析器会把它当语法错误吃掉，结果插入内容为空或乱码——而且 Sublime 不报任何提示。
正确写法是用 包裹全部内容，且 CDATA 内部**不能缩进首行**，否则插入时会多出前导空格：
<content></content>
多行内容示例（React 函数组件）：
<content> {<br> return <div>$2</div>;<br>};$0]]></content>
-
$1是第一个跳转位，$0是最终光标停留位置 - 所有变量（
$1、$2、${3:default}）必须出现在 CDATA 的顶层文本流中，不能被 XML 标签或注释包裹 - 换行符会被原样插入，所以 CDATA 内的缩进=插入后的缩进；如需控制格式，要么写成单行，要么手动对齐空格
多个 <tabtrigger></tabtrigger> 冲突时，Sublime 不警告，只认最后修改的那个文件
你写了两个 snippet，都设了 <tabtrigger>for</tabtrigger>，一个在 for-js.sublime-snippet，一个在 for-py.sublime-snippet。如果后者修改时间更晚，那即使你在 Python 文件里敲 for + Tab，也有可能触发 JS 版本——因为 scope 冲突时，Sublime 优先按文件系统修改时间决定胜负，而不是按当前语法。
- 排查方法：在
Packages/User/目录下全局搜索<tabtrigger>for</tabtrigger>（用 VS Code 或系统搜索工具） - 确认哪些文件含该 trigger，按修改时间排序，删掉过期或重复的
- 更稳妥的做法是让 trigger 具备语言特征，比如
forjs、forpy，避免跨语言覆盖 - scope 更精确的 snippet 会自然胜出：一个
<scope>source.js</scope>和一个<scope>text.plain</scope>同 trigger，JS 文件里只会触发前者
最易被忽略的点：作用域不是“语言名”，而是 Sublime 内部语法标识符；它区分嵌套上下文（比如 .vue 文件里的 <script></script> 块是 source.js.embedded.html，不是 source.js）；而 CDATA 缩进问题导致插入后格式错乱，往往被误判为“snippet 没生效”。
