Mac如何实现VS Code配置插件的多机同步

必须用Settings Sync扩展配合GitHub Gist同步VS Code配置：先安装重启，再登录并勾选gist权限，手动上传生成cloudSettings私有Gist；新机需登录后下载并刷新扩展面板安装插件，且必须启用syncExtension开关；路径类设置需加// @sync false注释避免静默丢失。

在Mac上更换电脑，或者多添一台开发机，最麻烦的往往不是装VS Code本身，而是把插件和配置重新折腾一遍。settings.json、keybindings.json，以及已安装扩展列表，最好都能在多台Mac之间保持一致，不然时间很容易被这些重复配置一点点吃掉。问题在于，到了2024年底，最新的 Settings Sync 功能已经彻底停用，眼下能用的方案，只剩下通过 Settings Sync 扩展配合 GitHub Gist 来手动同步。

安装并登录Settings Sync扩展

打开VS Code → 左侧扩展图标 → 搜索“Settings Sync”（作者Shan Khan）→ 点击安装 → 【必须重启VS Code】，否则后续命令不会出现。

重启后按Cmd+Shift+P → 输入“Sync: Login” → 回车 → 跳转到GitHub授权页 → 【务必勾选gist权限】（其他如user:email可不选），否则上传会报401错误。

授权完成后自动返回VS Code，状态栏右下角出现灰色云图标，此时尚未开始同步，只是登录成功。

首次上传本地配置

按下Cmd+Shift+P，输入“Sync: Upload Settings”并回车后，扩展就会在GitHub Gist里自动创建一个名为cloudSettings的私有Gist，用来集中保存extensions.json、keybindings.json、settings.json等全部配置文件。

这一步必须手动触发，不会自动发生。上传完成后，VS Code会自动打开syncSummary.txt文件，里面列出本次同步的文件名和行数——【如果没看到这个文件，说明上传失败，检查GitHub Token权限是否含gist】。

此时去https://gist.github.com/你的用户名，能看到刚生成的cloudSettings Gist，点开可确认内容完整。

在另一台Mac上拉取配置

步骤一：在新Mac上安装VS Code → 安装Settings Sync扩展 → 重启。

步骤二：Cmd+Shift+P → “Sync: Login” → 用同一GitHub账户登录（无需再授权，Token已缓存）。

步骤三：Cmd+Shift+P → “Sync: Download Settings” → 回车 → 等待下载完成，状态栏显示“Synced”。

注意：下载只同步“安装清单”，不自动安装插件。打开扩展面板（Cmd+Shift+X），右上角点击刷新按钮，VS Code才会真正开始安装extensions.json里列出的全部插件。

关键开关：必须启用插件同步

方法一：Cmd+Shift+P → 输入“Sync: Advanced Options” → 回车 → 选择“Toggle Extension Sync” → 确保状态变为Enabled。

方法二：直接编辑settings.json，在任意位置添加一行：
"syncExtension": true,

不开启此开关，extensions.json永远不会上传或下载，插件列表永远空白——这是最常被忽略的一步，【默认是关闭的】。

规避路径字段静默丢失

macOS上python.defaultInterpreterPath、terminal.integrated.profiles.osx这类绝对路径字段，会被Settings Sync自动过滤，不报错也不提示，导致新设备Python解释器路径为空、终端配置失效。

解决办法：在settings.json中对应行上方加注释标记，例如：
// @sync false
"python.defaultInterpreterPath": "/opt/homebrew/bin/python3",

这样该行就不会被上传，你可以在每台Mac上单独配置，避免跨平台路径冲突。