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 同步文件夹），用本地路径同步更可控、更快、也更安全。
- 在
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，后者能被同步
settings.json 导致覆盖，或是插件升级后配置格式变更，旧同步文件直接让新版本崩溃。建议每周手动检查一次 Packages/User/ 下关键文件的时间戳和内容一致性。 
