使用 GitHub 驱动的 Settings Sync 可自动同步设置、快捷键、代码片段及扩展列表,实现多设备一致;2. 手动迁移可通过复制用户配置目录下的 settings.json、keybindings.json 和 snippets 文件夹完成;3. 扩展管理支持通过 code --list-extensions 导出并批量安装;4. 结合 Git 对配置文件进行版本控制,利用符号链接关联实际路径,提升配置复用性与团队协作效率。

在多设备间使用 VSCode 时,保持设置、插件和代码片段的一致性可以极大提升开发效率。虽然 VSCode 本身不自带云同步功能,但通过合理配置与工具辅助,完全可以实现完整的跨设备迁移与同步方案。
1. 使用 Settings Sync 扩展实现云端同步
VSCode 官方推出的 Settings Sync 功能(基于 GitHub 账号)是最简单高效的同步方式,支持同步以下内容:
- 用户设置(settings.json)
- 键盘快捷键(keybindings)
- 代码片段(snippets)
- 已安装的扩展列表
- 启用的主题与图标包
操作步骤:
- 登录 GitHub 账号:打开 VSCode,按下 Ctrl+Shift+P,输入 "Turn on Settings Sync"
- 选择“使用 GitHub 登录”并授权
- 选择要同步的数据类型
- 在其他设备上登录同一账号并开启 Sync,自动拉取配置
开启后,VSCode 会在后台自动同步更改,也可手动通过命令面板触发“Sync: Push”或“Sync: Pull”。
2. 手动备份与迁移配置文件
若不使用 Sync 功能,可通过直接复制配置文件实现迁移。VSCode 的用户数据存储在本地特定目录中:
- Windows: %APPDATA%\Code\User\
- macOS: ~/Library/Application Support/Code/User/
- Linux: ~/.config/Code/User/
关键文件包括:
- settings.json —— 所有自定义设置
- keybindings.json —— 快捷键配置
- snippets/ —— 用户代码片段目录
- argv.json —— 命令行参数(如启用实验性功能)
将这些文件打包备份,迁移到新设备对应路径下即可还原环境。
3. 扩展管理与批量安装
即使没有同步扩展本身,也可以快速恢复已安装列表:
- 导出扩展列表:code --list-extensions > extensions.txt
- 在新设备上批量安装:cat extensions.txt | xargs -n 1 code --install-extension
这个方法适合脚本化部署或 CI 环境初始化。
4. 配合 Git 管理配置版本
将 settings.json 和代码片段纳入 Git 管理,可实现版本控制与团队共享:
- 创建私有仓库存放配置文件
- 为不同项目或设备建立分支(如 work、personal)
- 结合符号链接(symlink)指向实际配置路径
例如在 macOS/Linux 上:
ln -s ~/dotfiles/vscode/settings.json ~/Library/Application\ Support/Code/User/settings.json这样既能统一管理,又能灵活切换配置。
基本上就这些。使用 Settings Sync 最省心,适合大多数用户;手动备份加脚本化管理更适合高级用户或需要精细控制的场景。关键是选一种方式并坚持使用,避免配置散乱。










