VSCode跨设备配置同步需启用Settings Sync功能,支持GitHub或Microsoft账户登录,可同步设置、插件、快捷键等,并提供冲突处理与安全关闭选项。

如果您在多台设备上使用 VSCode,但每次更换设备都需要手动重新配置主题、插件和快捷键,则可能是由于未启用或未正确配置“Settings Sync”功能。以下是实现跨设备同步配置的具体步骤:
本文运行环境:MacBook Air,macOS Sequoia。
一、通过 GitHub 账户启用 Settings Sync
VSCode 使用 GitHub 作为身份验证和同步后端,启用前需确保已登录 GitHub 账户并授权 VSCode 访问权限。该方式支持完整同步设置、扩展、键盘快捷键、用户片段及 UI 状态。
1、启动 VSCode,在命令面板中按 Cmd + Shift + P(macOS)或 Ctrl + Shift + P(Windows/Linux)。
2、输入 Settings Sync: Turn On 并回车。
3、选择 GitHub 作为登录提供者。
4、在弹出的浏览器窗口中完成 GitHub 授权流程,返回 VSCode 后确认同步范围。
二、通过 Microsoft 账户启用 Settings Sync
Microsoft 账户是 VSCode 官方支持的另一同步通道,适用于已登录 Microsoft 生态(如 Outlook、OneDrive)的用户,无需额外安装 GitHub 应用或配置 OAuth。
1、打开命令面板,输入 Settings Sync: Turn On 并执行。
2、在提供者列表中选择 Microsoft。
3、使用 Microsoft 账户登录,并授予 Visual Studio Code Settings Sync 权限。
4、勾选需同步的项目类型,点击 Turn On 完成初始化。
三、手动触发同步与冲突处理
当多设备配置存在差异时,VSCode 不会自动覆盖,而是提示用户选择以哪台设备的配置为权威源。此机制可防止误操作导致关键设置丢失。
1、在命令面板中输入 Settings Sync: Show Conflicts 查看当前冲突项。
2、对每项冲突,点击 Accept Incoming(采用远程配置)或 Accept Current(保留本地配置)。
3、如需强制全量上传本地设置,执行 Settings Sync: Upload。
四、禁用同步并保留本地配置
在退出共享设备或进行敏感开发环境隔离时,可安全关闭同步功能而不删除本地已有设置、插件或快捷键绑定。
1、打开命令面板,输入 Settings Sync: Turn Off 并执行。
2、在确认弹窗中选择 Keep Local 选项。
3、VSCode 将清除同步元数据,但所有已安装扩展、用户设置文件及工作区配置均保留在当前设备中。










