VSCode如何同步设置到多台设备_配置云同步步骤

VSCode 设置同步依赖 GitHub 账户而非 Microsoft 账户，需授权 GitHub gist 权限；同步内容含设置、扩展、快捷键等，但自动过滤敏感字段（如 apiKey、token）；多设备同步需手动选择合并项，失败常见于 token 过期或网络拦截。

VSCode 同步设置依赖 GitHub 账户而非 Microsoft 账户

VSCode 的设置同步功能（Settings Sync）默认使用 GitHub 账户登录，不是 Microsoft 或 GitHub Copilot 账户。如果你用微软账号登录了 VSCode 却没开启同步，大概率是因为没绑定 GitHub —— 这是用户最常卡住的第一步。

• 打开 VSCode，按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Preferences: Turn on Settings Sync 并回车
• 系统会跳转到 GitHub 授权页，必须勾选 user:email 和 read:user 权限（仅用于识别账户和同步配置，不涉及仓库操作）
• 授权后，VSCode 自动上传当前配置（包括 settings.json、已安装扩展、键盘快捷键、代码片段、UI 布局等）到 GitHub Gist，生成一个私有 sync gist

多台设备上启用同步时需手动触发拉取

新设备首次开启同步不会自动覆盖本地设置，而是进入「冲突选择」流程：VSCode 会列出远程与本地的差异项（比如某扩展在 A 机装了、B 机没装），你得主动勾选要同步的内容。

• 在第二台设备上执行 Preferences: Turn on Settings Sync，登录同一 GitHub 账户
• 弹出的对话框中，取消勾选 Extensions（如果你本地已有特定版本扩展，避免被降级）；但建议保留 Settings、Keybindings、Snippets
• 点击 Continue 后，VSCode 会下载远程 gist 并合并——注意：它不会删除你本地未上传的扩展，也不会覆盖你手动改过的 settings.json 里未被同步的字段

同步失败常见原因和对应检查点

错误信息如 Failed to sync: Bad credentials 或 Unable to fetch sync data 多数和 token 权限或网络策略有关，而非账号密码问题。

Napkin AI

Napkin AI 可以将您的文本转换为图表、流程图、信息图、思维导图视觉效果，以便快速有效地分享您的想法。

下载

• 检查 GitHub 的 Personal Access Token 是否过期：进入 GitHub Settings → Developer settings → Personal access tokens，确认 token 存在且权限包含 gist（Settings Sync 强制要求）
• 企业网络或代理可能拦截 gist.github.com 请求，可临时切换网络测试；也可在 VSCode 设置中搜索 sync: gist，确认 sync.gist 值为空（非空表示被手动修改过，应保持默认）
• 如果某台设备同步后扩展列表异常（比如变空），检查该设备是否启用了 extensions.autoUpdate：设为 false 可防止同步后自动升级引发兼容问题

敏感配置（如 API key、本地路径）不会被同步

VSCode 同步机制默认排除以下内容：所有以 http、https、ftp 开头的字符串值；含 key、token、password、secret 等关键词的配置项；以及 files.excludes 中定义的路径模式。这是硬编码过滤逻辑，无法关闭。

• 例如你在 settings.json 中写了 "myExtension.apiKey": "abc123"，这个字段根本不会上传到 gist
• 但像 "editor.fontSize": 14 或 "workbench.colorTheme": "One Dark Pro" 这类通用设置会完整同步
• 若需跨设备共享敏感配置，应改用环境变量（如 process.env.MY_API_KEY）或独立的 .env 文件 + 扩展（如 dotenv 插件），不要塞进全局 settings

{
  "editor.fontSize": 14,
  "workbench.colorTheme": "One Dark Pro",
  "myExtension.apiKey": "abc123"
}