想在 Sublime Text 4 里用上 Sync Settings 同步你的配置？这事儿能成，但得先跨过两道坎：插件版本得是 v3.0 或更高，同时你的 ST4 内核也得是比较新的版本。好消息是，2026 年主流发行版基本都达标了。很多朋友遇到的“装不上”、“菜单不出现”、“点了没反应”，十有八九是卡在了这两步之前。
第一步：先确保 Package Control 是活的
Sync Settings 这插件，完全依赖 Package Control 来启动和管理。所以，别以为装完它自己就能蹦出来。首先得验证 Package Control 是否在正常工作：
- 按下
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），调出命令面板。 - 输入
Package Control: Install Package并执行——如果能顺利弹出插件搜索框，那才算过关。 - 如果没反应或者报错，那说明 Package Control 本身可能损坏或没装好。这时候先别急着找
Sync Settings，得先把 Package Control 重装一遍。记得去官网复制最新的安装命令，旧版的脚本可能会因为哈希校验失败而装不上。 - 等 Package Control 确认工作正常后，再执行
Package Control: Install Package，搜索Sync Settings进行安装。注意，别选那个带(Deprecated)标记的旧版。
第二步：手动触发设置，Token权限要对
插件安装成功，只是万&里长征第一步。它不会自动弹窗，也不会在后台默默开始同步。一切都要从你手动执行 Sync Settings: Setup 这个命令开始：
- 同样打开命令面板，输入并运行
Sync Settings: Setup。 - 这会跳转到 GitHub 的 OAuth 授权页面。这里有个关键点：权限只勾选
gist这一项。勾选其他权限（比如repo）不仅多余，还可能因为所在组织的策略限制导致 Token 创建失败。 - 生成的 Token 只会显示一次，务必第一时间完整复制，并粘贴回 Sublime Text 弹出的输入框里。如果手滑粘贴到了浏览器地址栏或别的文本编辑器里，那后续就全完了——配置文件里的
github_token字段会是空的，所有上传操作都会静默失败。 - 最后，检查配置文件
Packages/User/Sync Settings.sublime-settings，确认里面的gist_id和github_token都已经是非空的字符串。到这一步，基础配置才算真正落地。
第三步：小心“上传成功”的假象
很多人会在这里踩坑：控制台明明显示了 Upload completed，就以为万事大吉。其实，这仅仅表示 HTTP 请求发出去了，并不代表 Gist 创建成功或者内容被正确写入。
- 常见的失败原因包括：Token 过期或错误、网络中断、或者 GitHub Gist 服务临时抽风。
- 最可靠的验证方法是，上传后立刻去查看
Packages/User/Sync Settings.sublime-settings文件。如果里面的gist_id仍然是空的，那说明这次上传根本没在云端创建出有效的 Gist 记录。下次你再上传时，插件会新建一个 Gist，旧的配置就彻底找不回来了。 - 如果控制台报
401 Unauthorized错误，那基本可以锁定是 Token 出了问题，需要重新走一遍Setup流程。 - 另外要明确同步范围：插件默认只同步
Packages/User/目录下的文件。如果你的代码片段文件.sublime-snippet放在Packages/Emmet/这类子目录下，是不会被打包的。同样，Preferences.sublime-settings的原文件在Packages/Default/，也不会被上传。
离线或内网环境？试试本地同步模式
如果你的工作环境无法访问 GitHub（比如严格的企业内网、有网络限制的公共场所，或者你就是不想把配置传到云端），Sync Settings 其实提供了纯本地同步模式，完全不需要网络。
- 打开
Preferences → Package Settings → Sync Settings → Settings。 - 在用户配置文件中填入以下内容：
{ "sync_local": true, "local_path": "/path/to/shared/folder/sublime-sync" } - 这里的
local_path需要设置为所有设备都能访问的共享路径。可以是 NAS 的挂载目录、OneDrive/Dropbox 的同步文件夹，甚至是一个 USB 设备（但要确保每次插入后系统分配的路径一致）。 - 首次使用时，仍需手动运行一次
Sync Settings: Upload，将当前配置写入这个本地目录。之后在其他设备上，运行Download命令即可拉取配置，全程不经过网络。
最后提个醒：配置同步不是一个“上传一次就结束”的单向操作，而是一个“上传 → 他人下载 → 他人修改并上传 → 你再次下载”的闭环。只要任何一端漏掉了 Download 操作，或者不小心删除了配置文件中的 gist_id，整个同步链就会脱节。一个实用的建议是，把那个关键的 gist_id 手动备份在你的密码管理器或记事本里，这比单纯靠记忆要可靠得多。
