sublime text 的 snippet 必须使用 .sublime-snippet 后缀、存于 packages/user/ 目录，scope 属性决定生效语法（如 source.js），content 中 cdata 需顶格书写且避免多余换行缩进，xml 格式错误会导致静默失效。
Snippets 文件必须用 .sublime-snippet 后缀
Sublime Text 不会识别 .xml、.txt 或无后缀的文件作为 Snippet。哪怕内容完全正确，只要后缀不对，就无法在 Ctrl+Shift+P 里搜到或通过 Tab 触发。
正确做法是：新建文件 → 保存为 xxx.sublime-snippet（例如 log-console.sublime-snippet）→ 存放在 Packages/User/ 目录下（可通过 Preferences → Browse Packages… 打开）。
- Windows 路径示例：
%APPDATA%\Sublime Text\Packages\User\ - macOS 路径示例：
~/Library/Application Support/Sublime Text/Packages/User/ - Linux 路径示例：
~/.config/sublime-text/Packages/User/
scope 属性决定 Snippet 在哪种语法下生效
不写 scope，Snippet 默认只在纯文本（text.plain）中可用；写错 scope，比如把 source.js 写成 javascript，它就根本不会出现在 JS 文件里。
查当前文件真实 scope 的方法：打开目标文件 → 按 Ctrl+Shift+P → 输入 View Package File → 选中并执行，底部状态栏会显示当前语法对应的 scope（如 source.js、source.python、text.html.basic）。
- 常见 scope 值：
source.js、source.python、text.html.basic、source.css - 支持 scope 叠加，例如
source.js, source.ts表示同时在 JS 和 TS 文件中生效 - scope 区分大小写，
Source.Js是无效的
tabTrigger 和 content 的换行与缩进要小心处理
Snippet 中的 content 是原样插入的，包括换行和空格。如果写成：
一款AI工具，主要用于Monitor and clean up invalid Codex authentication files in CPA. Check quota status, disable files returning 401 errors, and perform dual verification before deletion.，适合需要提升相关任务效率的用户。
<content></content>
实际插入时会在开头多一个换行，且缩进会被保留——这在函数体内触发时容易破坏代码对齐。
更稳妥的做法是把 放在行首，内容紧贴其后，结尾的 <code>]]> 也顶格写，并手动用 $0 控制光标最终位置：
<content></content>
-
$1、$2表示跳转顺序，$0是最终光标停靠点 - 避免在 CDATA 内部用 Tab 缩进，否则插入后会带多余空格
- 若需多行结构（如 if 块），每行开头不要空格，用
\t或显式空格控制缩进逻辑
修改后不用重启 Sublime，但需确保文件已保存且无语法错误
Sublime 会自动加载 Packages/User/ 下新增或变更的 .sublime-snippet 文件，但前提是 XML 格式合法。一个没闭合的标签或错位的引号，会导致整个 Snippet 失效，且没有任何报错提示。
验证方式：打开 Snippet 文件 → 按 Ctrl+Shift+P → 输入 Set Syntax: XML → 看是否高亮正常；再检查是否有红色波浪线（说明 XML 解析失败）。
- 常见 XML 错误：
<content></content>忘记闭合、scope值含未转义的&符号、双引号嵌套未转义 - 修改后可立即按
Ctrl+Shift+P输入Insert Snippet查看是否列出新项 - 如果 Snippet 出现在列表里但 Tab 不触发，大概率是
scope不匹配或当前文件语法被插件覆盖（比如某些 Vue 插件把.vue文件识别为text.html.vue）
