Sublime代码片段管理只需三步：文件平铺于Packages/User目录、scope精确匹配语言、Git同步仓库；命名用短横线分隔，禁用空格和子目录，XML格式与占位符须严格规范。
想把Sublime Text打造成趁手的代码片段库？其实没那么复杂。核心就三件事：文件放对位置、scope写准、同步交给Git。搞定这些，其他都是锦上添花的干扰项。
如何把 Packages/User 当作本地 snippet 仓库来用
首先得明确一点：Sublime Text本身并没有一个叫“片段库”的独立概念。你的Packages/User/目录，就是事实上的仓库根目录。所有以.sublime-snippet结尾的XML文件，只要躺在这个目录里，就会被编辑器自动加载，完全不需要任何注册或手动刷新。
- 别建子文件夹：比如
Packages/User/js/这种结构，Sublime是不认的。所有片段文件必须平铺在User/目录下。 - 命名要直白：文件名最好直接体现语言和用途，例如
py-print.sublime-snippet、html-5boilerplate.sublime-snippet。用短横线连接，清晰又好找。 - 避开空格和特殊字符：像
console log.sublime-snippet这种带空格的命名，很可能导致文件被默默忽略。 - 快速打开目录：最稳妥的方法是点击
Preferences → Browse Packages…，然后进入User文件夹。别自己手动拼系统路径，尤其是Windows系统下，AppData这类隐藏文件夹很容易走错。
多语言支持的关键不是“分类”，而是 scope 精确匹配
想让一个片段只在特定语言下生效？关键不在于文件名里打多少标签，而在于
- 基础scope示例：
source.js对应Ja vaScript，source.python对应Python，text.html.basic对应HTML，source.css对应CSS。记牢这几个，大部分场景就够用了。 - 注意语法插件的覆盖：像Vue或JSX这类文件，其scope常被语法插件改写。比如一个
.vue文件，其scope通常是source.vue，而不是source.js。不确定时，可以用Ctrl+Shift+P调出命令面板，输入Developer: Show Scope Name来查看光标所在处的真实scope。 - 支持多scope，但要克制：你可以用逗号分隔多个scope，比如
source.js, source.ts, source.jsx - scope写错的典型症状：输入你设定的触发词后按Tab键毫无反应，同时在命令面板里也搜不到这个片段。如果遇到这种情况，首先就该检查scope。
用 Git 同步 snippet 仓库比 Dropbox/iCloud 更可靠
跨设备同步代码片段，最干净、最可靠的办法就是把整个Packages/User/目录变成一个Git仓库。相比之下，用Dropbox或iCloud这类云盘同步，经常会因为文件锁、同步冲突或隐藏文件问题，导致XML解析失败，让你的片段神秘失效。
- 初始化仓库：以macOS为例，打开终端，进入
~/Library/Application\ Support/Sublime\ Text\ 3/Packages/User/目录，然后执行git init && git add . && git commit -m “init snippets”即可。 - 精准忽略文件：在
.gitignore文件中，可以通过!*.sublime-snippet和*的配合，确保只跟踪.sublime-snippet文件，忽略其他所有自动生成的缓存或配置文件。 - 无缝重载：在其他设备上clone这个仓库后，完全不需要重启Sublime Text。你只需要保存任意一个片段文件，编辑器就会自动重载所有片段。
- 一个慎用的命令：
git clean -fd。这个命令会清理未跟踪的文件，很可能误删Sublime自动生成的缓存（比如Package Control.cache），进而影响插件更新功能。
容易被忽略的细节：占位符、变量和 XML 格式容错极低
最后，也是最重要的一点：Sublime的代码片段文件，其XML格式极其严格。标签闭合、CDATA位置、占位符语法，哪怕只错一点点，整个文件就会静默失效——编辑器不会报任何错误，也不会有任何提示。
- 内容必须包裹在CDATA中：
包裹。直接写console.log($1); - 占位符的学问：
$1、$2表示光标跳转的顺序位，$0是最终光标停留的位置。${1:default}可以给占位符一个默认值。但要记住，占位符不能嵌套，像${1:${TM_FILENAME_BASE}}这种写法是无效的。 - 环境变量大小写敏感：像
$TM_FILENAME_BASE（当前文件名）、$CURRENT_YEAR（当前年份）这类环境变量，必须严格区分大小写，并且它们只在 - 检查文件扩展名：保存文件时，务必确认扩展名是
.sublime-snippet。特别是Windows用户，请先关闭“隐藏已知文件类型扩展名”的选项，否则很容易误存成log.txt这样的文件。
