sublime如何安装Sync Settings插件_sublime跨设备同步插件设置【详解】

Sync Settings 插件需手动完成三步：token授权、首次上传、路径确认；必须通过Package Control安装；仅同步Packages/User/下文件；自动上传需配置"auto_upload": true。

怎么装？别跳过 Package Control 这一步

Sublime Text 本身不带包管理器，Sync Settings 必须通过 Package Control 安装——它不是独立可执行插件，而是依赖 Package Control 的生态链组件。

• 没装 Package Control？先按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS），输入 Install Package Control，回车等待完成
• 再调出命令面板，输入 Package Control: Install Package，搜索并安装 Sync Settings（注意名称是 Sync Settings，不是 SyncedSideBar 或 SyncedSettings）
• 安装后不会弹窗、不会提示，必须手动运行后续命令才能激活

为什么 Setup 后没反应？token 权限和粘贴位置最关键

Sync Settings: Setup 命令会打开 GitHub OAuth 页面，授权后返回 Sublime 并生成一个 Personal Access Token。这个 token 决定你能写入哪个 Gist，也决定同步是否真正生效。

• 必须勾选 gist 权限（仅此一项即可，不要多选；其他如 repo 或 user 属于过度授权）
• token 只显示一次，复制后立刻粘贴进 Sublime 的输入框——不要粘贴到浏览器地址栏、不要保存在未加密笔记里
• 粘贴后回车，插件会把 token 写入 Packages/User/Sync Settings.sublime-settings，你可以打开该文件确认字段 "github_token" 是否存在且非空
• 如果 token 错误或过期，后续 Upload 会静默失败，控制台（Ctrl+`）可能报 401 Unauthorized

上传失败？检查 snippet 和配置是否真在 User 目录下

Sync Settings 只打包并上传 Packages/User/ 目录里的内容，它不扫描整个 Packages，也不读取插件自带的默认配置。

元典智库

元典智库：智能开放的法律搜索引擎

下载

• 你的 .sublime-snippet 文件必须手动放在 Packages/User/ 下，比如 Packages/User/log.sublime-snippet；如果它在 Packages/Emmet/ 里，就不会被同步
• 快捷键、主题、设置等同理：只有 Packages/User/Preferences.sublime-settings、Key Bindings.sublime-keymap 等才会被打包
• 执行 Sync Settings: Upload 后，若提示 Upload completed 但 Gist 里看不到文件，大概率是 gist_id 字段为空——说明这是首次上传，插件会新建 Gist 并写入 ID；但如果网络中断或 token 失效，ID 就不会写入，下次上传仍会失败

自动同步怎么开？别信“上传一次就万事大吉”

默认关闭自动上传，每次修改设置后不会自动推送到 Gist。想省事，得手动改配置。

• 进入 Preferences → Package Settings → Sync Settings → Settings
• 在右侧用户配置中添加：

  {
      "auto_upload": true
  }
  

• 注意：auto_upload 是布尔值，不是字符串；写成 "auto_upload": "true" 会导致失效
• 启用后，每次保存 Preferences.sublime-settings 或 Key Bindings.sublime-keymap 等受管文件时，插件会在后台触发上传——但不会通知你，需去 Gist 页面刷新确认