VSCode同步设置：在多台设备间保持配置一致_网络技术

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

可通过VSCode内置Settings Sync、GitHub Gist手动同步或符号链接云盘目录三种方式实现跨设备配置一致：一、用GitHub账号启用端到端加密同步；二、导出settings.json为Gist并curl拉取；三、将用户数据目录软链至iCloud/Dropbox。

如果您在多台设备上使用 VSCode，但每次更换设备都需要重新配置主题、插件和快捷键，则可能是由于设置未启用同步功能。以下是实现跨设备配置一致的步骤：

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

一、启用 VSCode 内置 Settings Sync

VSCode 自 1.71 版本起内置 Settings Sync 功能，通过 GitHub、Microsoft 或 GitLab 账户进行端到端加密同步，涵盖设置、键盘快捷方式、片段、扩展和 UI 状态。

1、打开 VSCode，按下 Cmd + Shift + P（macOS）或 Ctrl + Shift + P（Windows/Linux）调出命令面板。

2、输入并选择 Settings Sync: Turn On。

3、在弹出的身份提供者列表中，选择 GitHub 并完成 OAuth 授权流程。

4、勾选需同步的项目（如 Extensions、Settings、Keybindings），点击 Turn On 完成启用。

当无法使用内置同步（如企业环境禁用第三方登录），可将关键配置文件导出为 GitHub Gist，并在各设备上拉取更新。该方法完全可控，不依赖 VSCode 后端服务。

1、在 VSCode 中执行 Cmd + Shift + P，输入并运行 Preferences: Open Settings (JSON)，复制全部内容。

2、访问 gist.github.com，新建 Gist，将 settings.json 内容粘贴至文件，命名为 vscode-settings.json，设置为 Public 或 Private，点击 Create secret gist。

3、在目标设备上，打开 VSCode 设置 JSON 文件，清空内容后，使用 curl 命令下载最新版本：curl -sL [YOUR_GIST_URL]/raw > settings.json（需替换为实际 Gist raw 链接）。

VSCode 的用户数据目录（含 settings.json、keybindings.json、snippets/）可被重定向至云同步文件夹（如 iCloud Drive 或 Dropbox），再通过符号链接指向该路径，实现文件级实时同步。

1、退出所有 VSCode 实例。

2、将原用户数据目录移动至云盘：mv ~/Library/Application\ Support/Code ~/iCloud\ Drive/VSCode-Config（macOS）。

3、创建符号链接：ln -s ~/iCloud\ Drive/VSCode-Config ~/Library/Application\ Support/Code。

4、重启 VSCode，验证设置是否生效，检查 Help → Toggle Developer Tools → Console 是否报路径错误。