vscode 设置同步需启用 Settings Sync 功能,支持 gitHub 或 microsoft 账户登录,选择同步项后可手动上传、下载或处理冲突。

如果您在多台设备上使用 VSCode,但每次更换设备都需要重新配置主题、插件和快捷键,则可能是由于未启用 Settings Sync 功能。以下是启用并完成同步的步骤:
本文运行环境:macBook air,macOS Sequoia。
一、通过 github 账户启用同步
VSCode 的 Settings Sync 依赖 GitHub 账户进行身份验证与数据托管,启用后所有配置将加密上传至 GitHub 的私有 Gist 中。
1、打开 VSCode,按下 Cmd + Shift + P(Mac)或 Ctrl + Shift + P(windows/linux)调出命令面板。
2、输入 Settings Sync: Turn On 并回车。
3、选择 GitHub 作为登录提供方。
4、在弹出的浏览器页面中点击 Authorize visual studio Code 完成授权。
5、勾选需要同步的项目,包括 Extensions、Settings、Keybindings、Snippets、Tasks、Launch Configurations。
二、通过 Microsoft 账户启用同步
Microsoft 账户可替代 GitHub 作为同步后端,适用于已登录 Microsoft 帐户且偏好统一微软生态的用户,同步数据存储于 azure 云服务。
1、打开命令面板(Cmd + Shift + P 或 Ctrl + Shift + P)。
2、输入并执行 Settings Sync: Turn On。
3、在账户提供方列表中选择 Microsoft。
4、在跳转页面中使用有效的 Microsoft 帐户登录并同意权限请求。
5、在后续弹窗中确认同步范围,确保 Settings 和 Extensions 处于启用状态。
三、手动触发同步与冲突处理
当本地配置发生变更但未自动上传,或不同设备间出现配置差异时,需手动干预以确保一致性;同步冲突会以交互式提示方式呈现,需主动选择保留项。
1、打开命令面板,输入 Settings Sync: Show Synced Data 查看当前同步状态与最后更新时间。
2、若需强制上传本地更改,执行 Settings Sync: Upload。
3、若需拉取远程最新配置,执行 Settings Sync: Download。
4、当检测到冲突时,VSCode 将显示对比界面,点击 Accept Incoming 采用远程版本,或 Accept Local 保留当前修改。