package control未装好则所有同步方案无效；必须通过ctrl+shift+p输入“package control”后出现完整命令列表（如install package、list packages）验证，st4需用6f4c264a开头脚本或手动拖入package control.sublime-package至installed packages/并重启。
Package Control 没装好，后面所有同步方案都白搭。它不是“插件之一”，而是 Sublime 插件生态的底层调度器——没它，Sync Settings、GistSync 这类所谓“一键同步插件”根本不会出现在命令面板里，更别说运行。
先确认 Package Control 是否真装好了
别只看菜单里有没有“Install Package”。真正有效的验证方式是：
按 Ctrl+Shift+P（macOS 是 Cmd+Shift+P），输入 Package Control，必须看到一整列以 Package Control: 开头的命令（比如 Package Control: Install Package、Package Control: List Packages）才算成功。
如果只显示一个条目、点开报错 Unable to download packages，或者控制台刷出 ssl.SSLError，说明安装失败或被墙。
- ST4 用户必须用哈希值为
6f4c264a开头的安装脚本（旧版 ST3 脚本不兼容） - 执行脚本后必须完全退出并重启 Sublime Text，否则插件管理器不加载
- 国内网络下，直接访问
packagecontrol.io大概率超时，建议手动下载Package Control.sublime-package文件，放进Installed Packages/目录再重启 -
Preferences → Browse Packages…弹出的窗口上一级就是Installed Packages/路径，别硬记%APPDATA%或~/Library
Sync Settings 插件能用，但不推荐作为主力同步方案
它依赖 GitHub Gist，而所有 Gist 同步插件（包括 Sync Settings、GistSync）均已停更，底层调用的 GitHub v3 API 也已下线。即使你强行让它跑起来，也会频繁遇到：
-
Gist ID not found错误（token 过期或权限不足） -
.sublime-snippet文件因 XML 格式校验失败而静默失效（比如 scope 值错一位、换行符是 CRLF 而非 LF） - 上传后另一台电脑拉不到最新内容，因为插件不会自动
pull，得手动触发，且不处理冲突 -
Package Control.sublime-settings里的installed_packages列表可能被覆盖，导致插件列表丢失
真正可靠的一键同步：Git + Gitee + 符号链接
这不是“装个插件就完事”的方案，但它是目前唯一能稳定支撑多端、可回溯、不丢配置、不爆错的方式。核心就三步，全部操作前必须彻底退出 Sublime Text（检查进程是否残留，Windows 看任务管理器有无 sublime_text.exe，macOS/Linux 执行 pgrep -f sublime 应无输出）：
- 用
Preferences → Browse Packages…找到真实Packages/User/路径（ST4 用户注意路径含Sublime Text 4） - 把整个
User/文件夹移到本地 Git 仓库（如~/sublime-user-config），执行：git init && git add *.sublime-settings *.sublime-keymap *.sublime-snippet && git commit -m "init" - 推送到 Gitee 私有仓库（别公开！
Package Control.sublime-settings含插件列表，可能暴露使用习惯） - 在另一台电脑上克隆该仓库到对应
Packages/下，再用符号链接指向它：
macOS/Linux：ln -s ~/sublime-user-config ~/Library/Application\ Support/Sublime\ Text\ 4/Packages/User
Windows（管理员 CMD）：mklink /J "%APPDATA%\Sublime Text 4\Packages\User" "C:\path\to\sublime-user-config"
同步后插件不生效？不是同步错了，是漏了关键动作
Git 同步只管 Packages/User/，而插件本体（.sublime-package 文件）存在 Installed Packages/ 目录，这个目录不参与同步。所以：
- 每台新设备上，必须用
Package Control: Install Package重装一遍插件——它会读取Package Control.sublime-settings里的installed_packages列表，自动批量安装 - 如果某插件菜单变灰、命令搜不到，先检查
Preferences → Package Settings里有没有对应条目；没有说明Package Control没识别到它，重装即可 - 配色方案（
color_scheme字段引用的.tmTheme或.sublime-color-scheme）不在User/里，得单独找出来，和User/放同一级云盘或 Git 仓库路径 - 符号链接创建后，务必删掉原
User/目录（不是重命名！），否则 Sublime 会优先读空目录，导致配置全失效
Package Control 安装状态，这三处任何一个出错，都会让“一键同步”变成“手动救火”。尤其 Windows 上 mklink /J 必须用管理员权限，路径带空格必须加英文双引号——这些细节错一个，同步就卡在第一步。
