package control未装好则所有插件功能失效；必须用st4专用脚本（哈希以6f4c264a开头）安装，执行后重启并验证ctrl+shift+p中出现package control:命令列表才算成功。
Package Control没装好，后续全白搭
所有插件同步功能都依赖 Package Control，它不是可选组件，而是底层调度中枢。没装或装错版本（比如 ST4 用了 ST3 的旧安装脚本），Install Package 命令根本不会出现在命令面板里。
验证是否装好：按 Ctrl+Shift+P，输入 Package Control，能看到一整列以 Package Control: 开头的命令才算成功。如果只看到 Install Package 但点开后报错 Unable to download packages，大概率是网络代理或哈希校验失败——此时别硬等，直接换官方最新安装脚本：
import urllib.request,os,hashlib; h = '6f4c264a24d23ca7df454c82994c8f2d' + 'e'; pf = 'Package Control.sublime-package'; ipp = sublime.installed_packages_path(); urllib.request.install_opener(urllib.request.build_opener(urllib.request.ProxyHandler())); by = urllib.request.urlopen('http://packagecontrol.io/' + pf.replace(' ', '%20')).read(); dh = hashlib.sha256(by).hexdigest(); print('Error validating download: %s' % dh if dh != h else 'Success! Please restart Sublime Text to finish installation.'); open(os.path.join(ipp, pf), 'wb').write(by)
- 执行后必须重启 Sublime Text，否则插件管理器不生效
- 若提示
ssl.SSLError或超时，说明被墙，需手动下载Package Control.sublime-package文件，放到Installed Packages目录下再重启 - 路径可通过菜单
Preferences → Browse Packages…进入，上一级就是Installed Packages
代码片段库同步靠的是 Sync Settings 插件
Sublime Text 本身不提供云同步，所谓“一键同步代码片段”，实际是靠第三方插件 Sync Settings 把 snippets 目录打包上传到 GitHub Gist。它不自动识别你写的 snippet，必须手动归类到标准路径。
关键约束条件：
- 你的自定义代码片段必须放在
Packages/User/xxx.sublime-snippet下，放错位置（比如直接丢进Data根目录）不会被识别 -
Sync Settings默认只同步Settings、Key Bindings、snippets、packages四类，其他如color schemes需在插件设置里手动勾选 - 首次同步前，必须先在 GitHub 创建 Personal Access Token，并在
Sync Settings设置中填入，否则上传直接失败，错误信息是Gist ID not found
安装后配置路径：Preferences → Package Settings → Sync Settings → Settings，重点确认 "gist_id" 和 "access_token" 字段已填写，且 "files" 数组包含 "snippets"。
“一键同步”本质是两条命令的事
装好 Sync Settings 后，所谓“一键”指的就是命令面板里的两个操作，没有更简化的路径：
- 上传本地改动：按
Ctrl+Shift+P→ 输入Sync Settings: Upload→ 回车 → 等待右下角提示Upload successful - 拉取远程更新：按
Ctrl+Shift+P→ 输入Sync Settings: Download→ 回车 → 它会自动覆盖本地同名文件，不弹确认框
注意：Download 不会合并冲突，而是强制覆盖。如果你在两台机器上同时改了同一个 .sublime-snippet，后执行 Download 的那台会丢失另一台的修改——这不是 bug，是设计如此。真要协同编辑，得用 Git 管理 Packages/User 目录，而不是依赖 Gist 同步。
Snippet 文件名和 scope 决定触发时机
同步只是搬运文件，真正让代码片段“活起来”的是文件命名规则和 scope 声明。常见踩坑点：
- 文件名必须带
.sublime-snippet后缀，写成log.snippet或log.txt都无效 -
<scope></scope>标签值必须匹配语言语法定义，比如 C++ 片段写source.c++，写成source.cpp或source.c都不会在.cpp文件里出现 - 多个
<tabtrigger></tabtrigger>用空格分隔，不是逗号；大小写敏感，log和LOG是两个触发词 - 如果片段在某语言里不弹出，先检查当前文件右下角显示的语言名是否和
<scope></scope>一致，再查控制台是否有error loading snippet日志
Scope 列表可查官方文档，或直接打开一个目标语言文件，按 Ctrl+Shift+P 输入 Set Syntax 查看当前 scope 名称。
