VSCode的Setting Sync：一键同步你的所有配置

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）。

Github Issue Creator

将原始笔记、错误日志、语音或截图转为简洁的 GitHub 风格 Markdown issue 报告。适用于用户粘贴错误信息或随意描述并希望生成结构化 GitHub issue 的场景。支持图片/GIF 证据。

下载

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 保留当前修改。