必须用Settings Sync扩展配合GitHub Gist同步VS Code配置：先安装重启，再登录并勾选gist权限，手动上传生成cloudSettings私有Gist；新机需登录后下载并刷新扩展面板安装插件，且必须启用syncExtension开关；路径类设置需加// @sync false注释避免静默丢失。
Mac上换电脑或新增开发机后，VS Code插件和配置每次重装重配太耗时，必须让settings.json、keybindings.json、已安装扩展列表在多台Mac间保持一致——官方Settings Sync功能已在2023年底彻底停用，现在只能靠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上单独配置，避免跨平台路径冲突。
