配置同步

约 575 字大约 2 分钟

2025-06-19

目录
同步步骤
配置文件格式
可用选项
常用指令

简介

使用 Sync Settings 插件，可以在多台设备之间同步 Sublime Text 的配置，并通过 GitHub Gist 实现安全的跨平台备份。

安装插件：按 Ctrl + Shift + P，运行 Package Control: Install Package，搜索并安装 Sync Settings
获取 Token：访问 GitHub Personal Access Tokens，创建一个新 token，仅勾选 gist 权限，复制生成的 token
配置 Token：打开 Preferences → Package Settings → Sync Settings → Settings - User，填入 token：
```
{
    "access_token": "你的_github_token"
}
```
创建备份：按 Ctrl + Shift + P，运行 Sync Settings: Create and Upload，输入描述信息，上传成功后会显示提示
保存 gist_id：打开配置文件，复制其中的 access_token 和 gist_id，备用

同样安装 Sync Settings 插件
在 Preferences → Package Settings → Sync Settings → Settings - User 中，粘贴之前保存的 access_token 和 gist_id
按 Ctrl + Shift + P，运行 Sync Settings: Download，即可拉取远程配置

配置文件使用 JSON 格式，简化示例如下：

{
    "access_token": "ghp_xxxxxxxxxxxxxxxxxxxx",
    "gist_id": "xxxxxxxxxxxxxxxxxxxxxxxx"
}

名称	类型	说明
`access_token`	string	GitHub Gist 访问令牌，用于同步操作（仅下载时可选填）
`gist_id`	string	Gist ID，标识远程备份
`auto_upgrade`	boolean	设为 `true` 时，Sublime Text 启动时自动同步
`http_proxy`	string	HTTP 代理地址
`https_proxy`	string	HTTPS 代理地址
`excluded_files`	string[]	黑名单，匹配的文件不会被同步
`included_files`	string[]	白名单，匹配的文件会被同步（优先级高于 excluded_files）

提示：excluded_files 和 included_files 支持 glob 模式，如 *.log、settings.json 等。

按 Ctrl + Shift + P 打开命令面板，搜索 Sync Settings 可使用以下指令：

指令	说明
`Sync Settings: Create and Upload`	从本地创建新的 Gist 备份并上传
`Sync Settings: Delete and Create`	删除远程备份，从本地重新创建
`Sync Settings: Upload`	将本地最新配置上传到已有 Gist
`Sync Settings: Download`	从 Gist 拉取最新配置到本地
`Sync Settings: Delete`	删除远程 Gist 备份（⚠️ 不可恢复）
`Sync Settings: Show Logs`	打开同步日志
`Sync Settings: Edit User Settings`	打开用户配置文件