Sublime 的 snippet 必须放在指定路径（如 Packages/User/）才能被识别，tabTrigger 需唯一、无空格且匹配作用域，Tab 不生效常因路径错误、trigger 冲突、scope 不匹配或设置/插件劫持。
Snippets 文件必须放在正确路径才能被 Sublime 识别
Sublime 不会自动扫描任意位置的 .sublime-snippet 文件。它只从特定目录加载：用户 snippet 目录（Packages/User/）或插件自带的 Packages/xxx/ 下的 snippets/ 子目录。
- Windows：
%APPDATA%\Sublime Text\Packages\User\ - macOS：
~/Library/Application Support/Sublime Text/Packages/User/ - Linux：
~/.config/sublime-text/Packages/User/
如果把 snippet 文件丢在桌面或项目根目录，Tab 键永远不触发补全 —— 这是最常被忽略的起点错误。
Snippet 的 tabTrigger 必须唯一且不含空格
Sublime 匹配 Tab 补全时，只认 <tabTrigger>foo</tabTrigger> 中的纯文本内容，且区分大小写。一旦多个 snippet 使用相同 tabTrigger，只有最后加载的那个生效（通常按字母序覆盖）。
- ✅ 推荐写法：
<tabTrigger>log</tabTrigger>或<tabTrigger>fori</tabTrigger> - ❌ 无效写法：
<tabTrigger>console.log</tabTrigger>（含点号，多数语法下不匹配）、<tabTrigger>log </tabTrigger>（末尾空格导致无法触发） - ⚠️ 注意作用域：
<scope>source.js</scope>会让该 snippet 只在 JS 文件中响应 Tab，写错 scope（比如写成text.html却用在 .js 文件里）也会静默失效
Tab 键不补全？先检查是否被其他功能劫持
Sublime 默认用 Tab 触发 snippet，但这个行为可能被以下设置覆盖：
-
"auto_complete": true开启时，Tab 在自动完成弹窗出现后会选中高亮项，而非触发 snippet —— 此时需先按Esc关闭弹窗，再按 Tab -
"tab_completion": false会直接禁用所有 Tab 补全（包括 snippet 和单词补全），务必设为true - 某些插件（如 Emmet）会重绑定 Tab 键；若装了 Emmet，它默认接管 HTML/CSS 的 Tab，需在 Emmet 设置里关掉
"enable_tab_abbreviations_for_scopes"或调整 scope 白名单
验证方式：打开一个空白文件 → 输入 log → 按 Ctrl+Space（手动唤出补全列表），看 log 是否出现在 snippet 分类下。如果没出现，说明路径或 trigger 有问题；如果出现但 Tab 不动，就是上面这些设置冲突了。
进阶：用 view.run_command("insert_snippet") 手动调试
当 snippet 看似配置正确却无反应时，跳过 Tab 键，直接用命令面板测试是否能插入内容，可快速定位是“加载失败”还是“触发逻辑失败”：
- 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P）→ 输入Insert Snippet→ 回车 → 选择你的 snippet 文件 - 如果能成功插入，说明 snippet 内容和路径没问题，问题一定出在
tabTrigger、scope或全局 Tab 设置上 - 如果报错
No such file，说明路径不对或文件名不是.sublime-snippet后缀
真正麻烦的永远不是写 snippet，而是它藏在哪、谁在管它、什么时候轮到它说话 —— 多数时候，你缺的不是快捷键，是一次干净的重启 + 命令面板验证。
