sublime中如何使用Sync Settings插件同步配置？（多机同步）

Sync Settings 插件安装失败多因Package Control异常或ST版本不匹配（仅支持ST3/ST4且ST4需v3.0+）；安装后若无菜单项，需检查控制台报错如requests缺失，并手动安装依赖或改用local模式、GitHub token等方案。

Sync Settings 插件安装失败或不显示菜单项

插件没装上，多半是 Package Control 没正常工作，或者 Sublime Text 版本不匹配。Sync Settings 支持 Sublime Text 3 和 4，但不支持 ST2，且 ST4 需要 v3.0+ 版本插件。

• 先确认 Package Control 已安装：按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS），输入 Package Control: Install Package 能执行才算 OK
• 再执行 Package Control: Install Package → 输入 Sync Settings → 回车安装，别手快点错成 Sync Settings (Deprecated)
• 安装后重启 Sublime Text，右键菜单或 Preferences 下拉里应出现 Sync Settings 选项；若无，检查控制台（Ctrl+`）是否有报错，常见如 ImportError: No module named 'requests' —— 这说明插件依赖未自动安装，需手动补全（见下一条）

同步时提示 requests 模块缺失或网络超时

Sync Settings 默认用 GitHub Gist 存配置，底层依赖 requests 发 HTTP 请求。Sublime 的 Python 环境不自带这个包，插件会尝试自动安装，但常因代理、权限或网络策略失败。

• 手动安装 requests：打开终端，运行 subl --command "show_panel {\"panel\": \"console\"}" 后，在 Sublime 控制台中粘贴并执行以下命令（注意替换路径）：

  import urllib.request; exec(urllib.request.urlopen('https://bootstrap.pypa.io/get-pip.py').read()); import subprocess; subprocess.run([sublime.executable_path()[:sublime.executable_path().rfind('/')] + '/Packages/Python 3/Scripts/pip3', 'install', 'requests'])

• 更稳妥的做法是改用本地 gist token：在 GitHub 创建 Personal Access Token（勾选 gist 权限），然后在 Sublime 中打开 Preferences → Package Settings → Sync Settings → Settings，填入：

  {
    "gist_id": "",
    "access_token": "ghp_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
  }

• 如果公司网络限制外连，可考虑改用 local 模式（见下一条），避免所有网络依赖

用 local 模式绕过 GitHub 同步配置文件

不是所有场景都需要上云。多人共用同一套配置、或机器间有共享目录（如 NAS、OneDrive 同步文件夹），用本地路径同步更可控、更快、也更安全。

歌者PPT

歌者PPT，AI 写 PPT 永久免费

下载

• 在 Sync Settings → Settings 中设置：

  {
    "sync_local": true,
    "local_path": "/path/to/shared/sublime-sync"
  }

  路径必须存在且 Sublime 有读写权限
• local_path 下会生成 settings.json 和 Packages/ 文件夹，后者存放插件 zip 包 —— 注意：不同平台（Win/macOS/Linux）的插件路径结构略有差异，建议同平台同步
• 首次同步请手动触发 Sync Settings: Sync，而非 Sync Settings: Download，否则可能清空本地配置
• 多机同步时，务必确保只有一台机器在写，其他机器只读+拉取，否则 settings.json 冲突无法自动合并

哪些文件会被同步？哪些不会？

Sync Settings 默认只同步用户级配置，不碰 Sublime 自身安装目录或系统级设置，但具体范围得看配置项是否被显式列入白名单。

• 默认同步：Preferences.sublime-settings、Package Control.sublime-settings、Key Bindings.sublime-settings、Mouse Bindings.sublime-settings，以及 Packages/User/ 下所有文件（含插件自建的 *.sublime-settings）
• 明确不同步：Cache/、Index/、Local/、Packages/Default/、Packages/C++/ 等内置包内容；也不会同步 Packages/User/Package Control.cache/ 这类临时文件
• 想加同步项？修改 Settings 里的 "files" 数组，例如加入 "Packages/User/MyTheme.sublime-theme"；但注意路径是相对于 Packages/ 目录的
• 插件本身配置是否生效，取决于它是否把设置存到 Packages/User/ 下 —— 像 Emacs Pro Mode 就只读 Preferences.sublime-settings，而 SideBarEnhancements 会自己建 SideBarEnhancements.sublime-settings，后者能被同步