便携版Sublime Text的代码片段必须放于手动创建的Packages/User/目录下，路径需通过Preferences: Browse Packages…确认，且文件须为UTF-8无BOM编码、真实后缀为.sublime-snippet、修改后需完全重启才生效。
便携版 Sublime Text 默认不读取系统级 Packages 目录，代码片段必须显式放在其自带的 Packages/User/ 下才生效——不是“复制过去就能用”，而是路径、权限、缓存三者都得对。
便携版的 Packages/User 路径在哪
便携版不会自动创建 Packages/User/，你得手动建。启动 Sublime 后，按 Ctrl+Shift+P 输入 Preferences: Browse Packages…，它打开的目录就是当前运行实例的根 Packages 路径（比如 Sublime Text Build 4143\Data\Packages\）。在这个目录下新建 User 文件夹，所有 .sublime-snippet 文件必须放进去。
- 别去系统盘的
%APPDATA%\Sublime Text 3\Packages\User\——便携版完全不看那里 - 如果打开的是空文件夹，说明你还没触发过 Packages 初始化，先新建一个文件、保存为
.txt再关掉，再试一次Browse Packages… - 路径中含空格或中文不影响，但文件名不能以点开头（如
.vue.sublime-snippet会被忽略）
为什么保存了 snippet 还是不触发
便携版对文件系统变更更敏感，常见静默失败原因：
-
.sublime-snippet文件保存时被编辑器加了 BOM 或用了 UTF-8 with BOM 编码 —— 用 VS Code 或 Notepad++ 改成 UTF-8（无 BOM）再保存 - 文件实际后缀是
.sublime-snippet.txt（Windows 默认隐藏扩展名），右键属性确认真实后缀 - 修改了 snippet 但没重启 Sublime：便携版有时会缓存 XML 解析结果，改完必须完全退出再重开
-
<scope></scope>值和当前文件语法不严格匹配，比如 Vue 文件右下角显示Vue Component，但 snippet 写的是text.html.vue—— 按Ctrl+Shift+P输入Developer: Show Scope Name看光标处真实 scope
如何让 snippet 在多个语法中生效
一个 snippet 只能有一个 <scope></scope>，想跨语言（比如 JS + TSX 中都用 log），有两个办法：
- 复制一份 snippet 文件，改名（如
log-js.sublime-snippet和log-tsx.sublime-snippet），分别设<scope>source.js</scope>和<scope>source.tsx</scope> - 用更宽泛的 scope，比如
source（对所有源码类语法生效），但会污染 Markdown 或 JSON 等非代码文件，慎用 - 别写 scope —— 这会让 snippet 只在
Plain text模式下可用，几乎等于废掉
便携版最麻烦的不是配置，而是每次换机器或重装都要重新部署 Packages/User/。建议把这个文件夹打包压缩，存在 U 盘或云盘里，新环境解压即用——别指望“同步”或“插件管理”，便携版天生离线优先。
