如何利用vscode同步设置到不同设备【教程】

12次阅读

VS Code 设置同步需登录微软账户并开启同步开关,支持设置、扩展等六类内容同步;要求双端版本≥1.75、网络通畅、无忽略配置,扩展同步仅限 Marketplace 上架插件,ui 状态需关闭窗口才上传。

如何利用vscode同步设置到不同设备【教程】

VS Code 的设置同步功能默认就能用,不需要额外装插件或手动备份,但必须登录微软账户并开启同步开关——否则你改了设置,换台电脑打开还是原始状态。

同步前必须登录 microsoft 账户

VS Code 同步底层依赖的是微软账户(不是 gitHub 或 google 账户),即使你用 github 登录过 VS Code,也得单独绑定微软账户才能启用同步:

  • 打开命令面板(Ctrl+Shift+PCmd+Shift+P),输入 Preferences: Turn on Settings Sync,回车
  • 如果没登录,会跳转到网页授权页;务必使用微软账户(如 outlook.com / hotmail.com 邮箱)完成授权
  • 首次开启时,会提示你选择要同步的内容:设置、扩展、键盘快捷键、用户代码片段、UI 状态(如侧边栏展开状态)、已启用的扩展推荐 —— 建议全选,避免漏掉关键配置

不同设备间同步不生效的常见原因

同步失败通常不是功能坏了,而是几个细节没对上:

  • 两台设备都必须运行 VS Code 1.75+(旧版本用的是旧同步协议,已停用);检查方法:Help > About 查看版本号
  • 其中一台设备可能关闭了同步开关:打开命令面板,运行 Preferences: Toggle Settings Sync 确认是「Enabled」状态
  • 网络被拦截:VS Code 同步走的是 vscode-sync.trafficmanager.net,某些企业网络或防火墙会屏蔽该域名,可临时换 Wi-Fi 测试
  • 设置了 "sync.ignoredExtensions""sync.ignoreUploads" 等高级忽略项,导致部分配置没上传 —— 检查 settings.json 里是否有这类字段

扩展同步失败?重点看这三点

扩展经常不同步成功,尤其当你在一台机器上禁用了某个扩展、另一台却仍启用时:

  • 同步只管理「已安装且状态明确」的扩展:如果你在 A 机卸载了 esbenp.prettier-vscode,B 机会自动卸载;但如果你只是禁用它,B 机不会自动禁用
  • 私有扩展(比如本地 .vsix 安装的)不会同步,VS Code 只同步 Marketplace 上架的扩展 ID
  • 扩展设置(如 prettier.configPath)属于「设置」范畴,只要开启了设置同步,就会随 settings.json 一起同步,无需单独处理

同步不是实时的,通常在你修改设置、重启窗口或手动触发 Preferences: Sync Now 后才上传。最易被忽略的是:UI 状态(比如哪些文件夹被折叠、终端分组是否展开)只在关闭窗口时才上传,开着窗口切设备,这些状态不会立刻一致。

text=ZqhQzanResources