sublime代码片段管理只需三步：文件平铺于packages/user目录、scope精确匹配语言、git同步仓库；命名用短横线分隔，禁用空格和子目录，xml格式与占位符须严格规范。
Sublime 的代码片段管理不需要复杂工具链，核心就三件事：文件放对位置、scope 写准、同步靠 Git —— 其他都是干扰项。
如何把 Packages/User 当作本地 snippet 仓库来用
Sublime 不提供“片段库”概念，Packages/User/ 就是你的实际仓库根目录。所有以 .sublime-snippet 结尾的 XML 文件都会被自动加载，无需注册或刷新。
- 不要新建子文件夹（比如
Packages/User/js/），Sublime 不识别子目录下的 snippet，文件必须平铺在User/下 - 命名直接体现语言和用途，例如：
py-print.sublime-snippet、html-5boilerplate.sublime-snippet、vue-script-setup.sublime-snippet - 避免空格和特殊字符，
console log.sublime-snippet这种写法会导致文件不被识别 - 用
Preferences → Browse Packages…快速打开User/目录，别手动拼路径（尤其 Windows 隐藏AppData容易进错）
多语言支持的关键不是“分类”，而是 scope 精确匹配
一个 snippet 只能通过 <scope></scope> 控制生效范围，所谓“多语言标签分类”本质是合理设置 scope 值，而不是靠文件名打标签。
- 基础 scope 示例：
source.js（JS）、source.python（Python）、text.html.basic（HTML）、source.css（CSS） - Vue 或 JSX 文件常被语法插件覆盖 scope，比如
.vue文件默认是source.vue，不是source.js；用Ctrl+Shift+P输入Developer: Show Scope Name查当前光标处真实 scope - 支持逗号分隔多个 scope：
<scope>source.js, source.ts, source.jsx</scope>，但别堆太多，scope 判断有性能开销 - scope 写错最典型现象：输入
tabTrigger后按 Tab 没反应，且命令面板里也搜不到该 snippet
用 Git 同步 snippet 仓库比 Dropbox/iCloud 更可靠
把整个 Packages/User/ 目录作为 Git 仓库，是跨设备同步 snippet 最干净的方式。Dropbox 或 iCloud 容易因文件锁、冲突或隐藏文件导致 XML 解析失败。
- 初始化：
cd ~/Library/Application\ Support/Sublime\ Text\ 3/Packages/User/（macOS），然后git init && git add . && git commit -m "init snippets" - 注意忽略非 snippet 文件：在
.gitignore里加!*.sublime-snippet和*，只保留 snippet 文件 - 不同设备 clone 后，无需重启 Sublime，保存任意 snippet 文件即自动重载
- 慎用
git clean -fd，它会删掉 Sublime 自动生成的缓存文件（如Package Control.cache），可能影响插件更新
容易被忽略的细节：占位符、变量和 XML 格式容错极低
snippet 文件不是“写完就能用”，XML 标签闭合、CDATA 位置、占位符语法稍错一点，整个文件就静默失效 —— Sublime 不报错，也不提示。
-
<content></content>必须包裹在内，不能直接写<content>console.log($1);</content>（会 XML 解析失败） - 占位符用
$1、$2表示跳转位，$0是最终光标位置；${1:default}提供默认值，但不能嵌套，比如${1:${TM_FILENAME_BASE}}无效 - 环境变量如
$TM_FILENAME_BASE、$CURRENT_YEAR全部大小写敏感，且只在<content></content>的 CDATA 区域内生效 - 文件保存时确认扩展名是
.sublime-snippet，Windows 用户要关掉“隐藏已知文件类型扩展名”，否则容易存成log.txt
