VSCode多设备环境同步可通过四种方式实现:一是启用内置Settings Sync功能,依托GitHub或Microsoft账户自动同步设置、扩展等;二是手动复制用户数据目录(macOS路径为~/Library/Application Support/Code/User/);三是安装Sync Settings扩展,使用GitHub Gist托管配置并支持增量更新;四是将配置目录纳入Git版本控制,实现历史管理与团队共享。

如果您希望在多台设备上保持一致的VSCode开发环境,但手动导出导入设置与扩展效率低下且易遗漏,则可能是由于缺乏系统化的配置管理机制。以下是实现VSCode设置与扩展自动备份和同步的具体操作步骤:
本文运行环境:MacBook Air,macOS Sequoia。
一、使用Settings Sync内置功能
VSCode自1.84版本起集成Settings Sync功能,依托GitHub或Microsoft账户实现云端同步,可自动同步设置、键盘快捷键、用户片段、已安装扩展及工作区扩展推荐。
1、启动VSCode,点击左下角齿轮图标,选择“设置同步已关闭”或“打开设置同步”。
2、点击“登录并同步”,选择GitHub或Microsoft账户完成授权。
3、在弹出的同步选项面板中,勾选“设置”“扩展”“键盘快捷方式”“用户片段”四项。
4、点击“确定”,等待状态栏右下角显示已同步提示。
二、通过配置文件手动导出与导入
VSCode将用户配置以纯文本形式存储于本地文件系统,直接复制相关目录即可完成完整环境迁移,适用于离线场景或需版本控制的场合。
1、关闭所有VSCode实例。
2、定位用户数据目录:macOS路径为 ~/Library/Application Support/Code/User/。
3、将该目录下的 settings.json、keybindings.json、snippets/ 文件夹及 extensions/ 目录整体压缩为 archive.zip。
4、在目标机器上解压至对应路径,确保目录结构完全一致。
三、利用第三方扩展Sync Settings
Sync Settings扩展提供更细粒度的同步控制,支持自定义同步范围、Git仓库托管及增量更新检测,兼容旧版VSCode且无需依赖微软账户。
1、在VSCode扩展市场搜索“Sync Settings”,安装由 Shan Khan 发布的同名扩展。
2、按 Cmd+Shift+P 打开命令面板,输入“Sync Settings: Setup”,回车后选择“GitHub Gist”作为存储后端。
3、登录GitHub并生成Personal Access Token,权限至少包含 gist。
4、粘贴Token并保存,随后执行“Sync Settings: Upload”上传当前配置。
5、在另一台设备安装相同扩展后,运行“Sync Settings: Download”拉取最新配置。
四、使用Git管理配置文件
将VSCode用户配置目录纳入Git版本控制,可实现历史追溯、多分支环境适配及团队共享标准开发模板。
1、在终端中进入 ~/Library/Application Support/Code/User/ 目录。
2、执行 git init 初始化仓库,创建 .gitignore 文件,添加 extensions/ 以外的全部内容。
3、运行 git add . && git commit -m "Initial commit of VSCode settings"。
4、添加远程仓库地址(如GitHub私有库),执行 git push origin main 完成首次推送。
5、在新设备上克隆该仓库至相同路径,覆盖原有文件后重启VSCode。










