推荐使用 VS Code 内置的 Settings Sync 功能(自 1.84 起支持),登录 GitHub 账号并授权 gist 权限后,可自动同步设置、快捷键、代码片段、扩展等至私有 Gist;手动方式则需导出 settings.json 和 extensions.txt 并上传至 Secret Gist,适合需版本控制或敏感信息管理的场景。

把 VS Code 设置同步到 GitHub Gist 是个轻量又可靠的方式,适合个人多设备间快速恢复开发环境。核心思路是:用官方扩展 Settings Sync(现名 GitHub Copilot Settings Sync 已整合)或手动导出/上传配置文件,再通过 Gist 管理。
使用 Settings Sync 扩展(推荐)
这是最简单、自动化的方案,由 VS Code 官方支持(自 1.84 起内置,无需额外安装):
- 打开 VS Code → 点击左下角齿轮图标 → 选择 Turn on Settings Sync…
- 登录 GitHub 账号,授权访问(仅需
gist权限) - 勾选要同步的内容:设置(settings.json)、快捷键、代码片段、已安装扩展、UI 状态等
- 点击 Turn On,VS Code 会自动创建一个私有 Gist 并上传配置
之后每次修改设置或装新插件,都会自动推送到该 Gist;在另一台机器登录同一账号并开启同步,即可一键拉取。
手动同步 settings.json 到 Gist
适合想完全掌控内容、或需版本管理/协作审查的场景:
- 找到你的用户设置文件:
Windows:%APPDATA%\Code\User\settings.json
macOS:$HOME/Library/Application Support/Code/User/settings.json
Linux:$HOME/.config/Code/User/settings.json - 复制内容,访问 gist.github.com → 新建 Gist → 粘贴,命名为
vscode-settings.json→ 设为 Secret(不公开)→ Create secret gist - 后续更新时,可手动覆盖,或用脚本+
gh gistCLI 自动化
同步扩展列表(extensions.json)
光有 settings.json 不够,扩展也得一并同步:
- 在终端运行:
code --list-extensions > extensions.txt - 将
extensions.txt也上传到同一个 Gist(或新建一个),方便重装时批量安装:cat extensions.txt | xargs -I {} code --install-extension {}
注意事项和小技巧
避免踩坑,提升同步稳定性:
- Gist 默认不跟踪修改历史,如需版本控制,建议用私有 GitHub 仓库替代 Gist(配合
.vscode/目录) - 敏感信息(如 API key、路径)不要写进
settings.json,改用settings.jsonc注释掉,或用user-data-dir隔离 - 不同系统(Win/macOS/Linux)的设置可能有差异,可在
settings.json中用"[javascript]": {...}或"editor.fontSize"的平台前缀做条件配置
基本上就这些。用 Settings Sync 是最快上手的,手动方式更透明可控——选哪个,看你想要省事还是留余地。










