VSCode的Settings Sync功能：跨设备同步你的所有配置_网络技术

发布时间 - 2026-01-10 00:00:00 点击率：次

启用Settings Sync可解决多设备VSCode配置不一致问题：一、用GitHub账户授权同步；二、可用Microsoft账户替代；三、手动重置并强制同步；四、关闭时选Keep Local保留本地配置。

如果您在多台设备上使用 VSCode，但每次更换设备都需要重新配置主题、插件和快捷键，则可能是由于 Settings Sync 功能未启用或配置异常。以下是启用并修复 Settings Sync 的多种方法：

本文运行环境：MacBook Air，macOS Sequoia。

一、通过 GitHub 账户启用同步

VSCode 默认支持使用 GitHub 账户作为身份验证源来同步设置，该方式无需额外安装扩展，且与 GitHub 的个人访问令牌（PAT）深度集成。

1、打开 VSCode，按下 Cmd + Shift + P 调出命令面板。

2、输入 Settings Sync: Turn On 并回车。

3、在弹出的浏览器窗口中，使用 GitHub 账户登录，并授权 vscode-sync 应用访问权限。

4、选择要同步的内容类型，包括 Settings、Keybindings、Extensions、Snippets、UI State，全部勾选后点击“Continue”。

当 GitHub 账户不可用或企业策略限制第三方 OAuth 时，Microsoft 账户可作为官方支持的替代身份源，其令牌由 VSCode 官方服务托管，无需手动管理 PAT。

1、在命令面板中执行 Settings Sync: Turn On。

2、在登录页底部点击 Sign in with Microsoft 链接。

3、输入 Microsoft 账户邮箱，完成双重验证流程。

4、返回 VSCode 后，确认同步范围并点击 Turn On。

当新设备拉取的设置明显缺失（如插件未自动安装或主题还原失败），说明本地与云端状态不同步，需强制刷新同步状态。

1、确保已启用同步后，在命令面板中输入 Settings Sync: Show Synced Data 查看当前同步摘要。

2、执行 Settings Sync: Reset Sync Data，选择 Reset and Re-upload 清除云端旧快照。

3、关闭所有 VSCode 窗口，重新启动编辑器。

4、等待右下角出现 Sync completed successfully 提示。

若需彻底退出同步体系但保留当前设备的所有自定义设置（如私有 snippet 或本地 keybinding.json 修改），必须避免误删本地文件。

1、执行 Settings Sync: Turn Off，在弹窗中选择 Keep Local 而非 “Remove All”。

2、手动检查 ~/Library/Application Support/Code/User/（macOS）路径下是否存在 syncLocal.json 文件，该文件记录了上次同步前的本地快照。

3、将 keybindings.json、settings.json 和 snippets/ 目录整体复制至安全位置。