Sublime Text 自定义 Snippet 必须满足三个硬性条件：文件存于 Packages/User/ 目录、后缀为 .sublime-snippet、scope 与当前文件真实语法作用域严格匹配，缺一则静默失效。
Sublime Text 本身没有叫 QuickAdd 的官方功能或插件，你搜到的“QuickAdd”大概率是混淆了其他编辑器（如 VS Code 的 Quick Add 扩展）、第三方非主流插件，或是对 New Snippet 功能的误称。真正能稳定、通用、无需额外依赖的高频代码插入方案，就是 Sublime 原生的 .sublime-snippet 机制——但它必须满足三个硬性条件，缺一不可。
文件名和存放路径必须严格为 Packages/User/xxx.sublime-snippet
常见错误现象：文件明明写好了，log + Tab 就是没反应；资源管理器里看着是 log.sublime-snippet，实际却是 log.sublime-snippet.txt（Windows 默认隐藏扩展名）；或者文件被扔进了项目根目录、Packages/ 根目录、甚至 Packages/Emmet/ 这类插件目录。
- 唯一可靠路径获取方式：菜单 → Preferences → Browse Packages… → 直接进入弹出窗口里的
User文件夹 - 保存时在
Save As…对话框中**手动输入完整文件名**，例如：console-log.sublime-snippet - macOS/Linux 用户注意：
~/Library/Application Support/Sublime Text/Packages/User/或~/.config/sublime-text/Packages/User/是正确路径，但别手输——用Browse Packages…更稳
<scope></scope> 必须匹配当前文件的真实语法作用域
你在 .js 文件里敲 log + Tab 没反应？90% 是 <scope></scope> 写错了。不写 <scope></scope>，或写成 javascript、js 这种“人话”，Snippet 只会在右下角显示 Plain text 的文件里生效。
- 查真实 scope 的最快方法：在目标文件中按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac）→ 输入并执行Developer: Show Scope Name→ 看状态栏，例如：source.js、source.ts.embedded.html、text.html.vue - 合法 scope 示例：
source.js、source.ts、source.python、text.html.basic、source.css - 多个 scope 用英文逗号分隔，不能有空格：
source.js,source.ts✅｜source.js, source.ts❌ - 调试时可临时设为
text.plain，确认 snippet 能触发后再换回精确 scope
<content></content> 里写 HTML/JS/JSX 必须用
直接把带 、<code>&、" 的代码（比如 React 组件模板或带属性的 HTML 标签）塞进 <content></content>，XML 解析器会报错或静默截断——这是新手最常踩的坑，且毫无提示。
- 错误写法：
<content><div class="container">${1}</div></content> - 正确写法：
<content>${1}]]></content> - 占位符用法：
${1:this}表示光标首次停留位置，默认值this；${2:default}表示按 Tab 后跳转的第二处；$0表示最终光标位置 - 如果内容纯文本无特殊字符（如
console.log(${1});），可省略，但建议统一加上，避免后续改内容时翻车
真正的难点不在“怎么写”，而在“怎么让 Sublime 看得见它”——路径、后缀、scope，三者像一把三叉锁，任意一齿没对准，Snippet 就彻底隐身。很多人花半小时写完内容，却卡在路径拼错或 scope 猜错上两小时。动手前，先用 Browse Packages… 定位目录，再用 Developer: Show Scope Name 确认 scope，比反复重启 Sublime 有效得多。
