Sublime Text 4同步配置教程 如何安装Sync Settings插件

想在 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 手动备份在你的密码管理器或记事本里，这比单纯靠记忆要可靠得多。