# 使用 Sync Settings 同步 Sublime Text 3 设置

使用Sync Settings (opens new window) ,可以在多个设备之间同步Sublime Text 3的设置,并保持更新。

同步由GitHub-Gists支持,为您提供了可靠的跨平台解决方案,以确保备份安全。

# 步骤

  1. 打开Sublime Text 3 ,按住Ctrl+Shift+P,运行Package Control: Install Package命令,并找到 Sync Settings,点击运行。
  2. 访问github.com (opens new window) ,创建一个新的personal access token,只需要勾选gist选项。复制生成的token备用。
  3. 在Sublime Text 3中打开Preferences > Packages Settings > Sync Settings > Settings - User配置文件,输入
{
    "access_token": "刚复制的token"
}
  1. 在Sublime Text 3中打开Preferences > Packages Settings > Sync Settings > Sync Settings: Create and Upload,并随意输入一个描述,上传成功后会有提示。
  2. 打开配置文件,复制里面的所有内容备用,包含access_token 和 gist_id。
  3. 在需要下载配置的客户端同样安装此插件,并打开Preferences > Packages Settings > Sync Settings > Settings - User, 将刚才复制的内容(access_token与gist_id)粘贴进去并保存。
  4. 打开Preferences > Packages Settings > Sync Settings > Sync Settings: Download,同步成功后会有提示。

# 文件格式

请注意-配置文件使用JSON格式。一个简化的示例可能如下所示。

{ 
    "access_token":"xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "gist_id":"xxxxxxxxxxxxxxxxxxxxxxxxx"
}

# 选项

默认情况下,此插件在Sublime Text3软件包文件夹(即·/Users/marcelo/Library/Application Support/Sublime Text 3/Packages/User·)上运行,这意味着excluded_files和included_files会在该文件夹中查找文件。

name 类型 描述
access_token string 在您的gists(编辑,删除和创建)上赋予Sync Settings写权限。(如果只想下载备份,则不需要此选项)
gist_id string 您在gist.github.com上备份的标识符。
auto_upgrade boolean 如果是true,则在Sublime Text3启动时,您的设置将与gist.github.com上的最新设置同步。
http_proxy string 用于请求的HTTP代理服务器。
https_proxy string 用于请求的HTTPS代理服务器。
excluded_files []string 简而言之,此选项是黑名单。这意味着,与定义的模式匹配的每个文件在同步时都会被忽略。
included_files []string 简而言之,此选项是白名单。这意味着,与定义的模式匹配的每个文件都将包括在同步中,即使该文件包含在excluded_files选项中也是如此。

# 指令

command 描述
Sync Settings: Create and Upload 从本地创建一个新的备份到 gist.github.com
Sync Settings: Delete and Create 删除远程的备份并从本地创建一个新的备份到 gist.github.com
Sync Settings: Upload 将本地文件的备份上传到 gist.github.com
Sync Settings: Download 使用gist_id设置文件中定义的属性作为参考,检索备份的最新版本。
Sync Settings: Delete 使用gist_id设置文件中定义的属性作为参考,删除要点的远程版本。(此操作是不可逆的)
Sync Settings: Show Logs 用Sync Settings日志文件打开一个新视图
Sync Settings: Edit User Settings 使用Sync Settings用户设置打开一个新视图。