Sublime Text 自定义代码片段必须放在 Packages/User/ 目录下才生效，且仅扫描该目录一级子文件，不递归；scope 错误或未转义 $ 字符会导致静默失效。
Snippets 文件必须放在 Packages/User/ 才能生效
Sublime Text 不会扫描任意路径下的 .sublime-snippet 文件，只认两个位置：Packages/User/ 和第三方包目录（如 Packages/Emmet/）。自定义片段放错地方，比如丢进桌面或项目根目录，输入 tabTrigger 后完全没反应——这是最常被卡住的第一步。
- 用菜单
Preferences → Browse Packages…直接打开Packages文件夹，再进User子目录，这是唯一稳妥的落点 - 不要手动在
Packages/下新建同名文件夹（如Packages/Snippets/），Sublime 不识别这种路径 - 如果用了同步工具（如 GitHub 或 iCloud），确保同步的是整个
User/目录，而不是只同步其中几个文件
scope 写错会导致 Snippet “隐身”
一个 JS 片段写成 <scope>source.python</scope>，哪怕触发词输对、文件也确实是 .js 后缀，它也不会展开。Sublime 的语法作用域（scope）不是文件后缀，而是当前视图实际加载的 syntax definition。
- 查当前文件 scope：按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入“Show Scope Name”回车，状态栏会显示类似source.js meta.function.js的完整 scope 链 - 常用 scope 值：
source.js（JS）、source.ts（TS）、text.html.basic（HTML）、source.css（CSS），注意不是html或css - 不写
<scope>标签 = 全局生效，容易误触，不推荐
占位符 $1 $2 $0 和 ${1:default} 不是可选技巧，是基本功
只写 <content><![CDATA[ console.log(); ]]></content> 是半成品。没有占位符，每次都要手动删空括号、敲变量名，效率反而更低。
-
$1是第一个光标停靠点，$2是第二个，$0是最终光标位置（通常放末尾） -
${1:msg}表示带默认值msg的占位字段，Tab 跳到这儿时整块文字可直接编辑或回车跳过 - 别在
<content>里直接写$字符，得写成\$；含]]>的代码（如正则）要写成]]$NOT_DEFINED>
按语言建子文件夹？Sublime 不支持，但命名可以补救
有人想在 User/ 下建 js/、html/ 子目录来分类 snippets，结果发现这些文件根本不会被加载——Sublime 只扫 User/ 一级目录下的 .sublime-snippet 文件，不递归。
- 命名即分类：用前缀统一标识语言和用途，例如
js-console-log.sublime-snippet、html5-boilerplate.sublime-snippet、py-try-except.sublime-snippet - 命令面板中搜
Insert Snippet时，description和文件名都会显示，清晰的命名能快速定位 - 真正需要隔离管理时，建议用 Git 管理整个
User/目录，并在 README.md 里维护一份 snippet 映射表
$ 转义是最容易静默失败的两个点，其他问题大多能从文件路径和命名上一眼看出。把 Packages/User/ 当作你的本地 snippet 源码树来维护，比追求“自动分类”实在得多。 
