VSCode设置同步需手动启用并登录GitHub账户，同步内容包括配置、扩展列表、键位绑定等，但不包括工作区设置和敏感凭证；冲突时以最后上传者为准，扩展未安装常因网络、版本兼容或ID差异导致。
VSCode 的设置同步功能默认依赖 GitHub 账户，不是“开箱即用”，必须手动登录并启用——没完成这一步，Settings Sync 始终处于关闭状态，所有设备间的配置、扩展、键位绑定都不会流动。
怎么打开 Settings Sync 并完成首次登录
点击左下角齿轮图标 → Turn on Settings Sync... → 选择要同步的内容（推荐全选）→ 点击 Sign in with GitHub → 在浏览器中授权 vscode-auth 应用 → 回到 VSCode 确认同步启动。注意：必须使用 GitHub 账户，不支持 GitLab 或 Microsoft 账户直连；如果已登录 GitHub 但无响应，尝试在命令面板运行 Developer: Toggle Developer Tools 查看控制台是否有 401 Unauthorized 报错，大概率是令牌过期或权限不足。
同步哪些内容？哪些不会被同步？
默认同步项包括：Settings（settings.json）、Keybindings（keybindings.json）、Extensions（已安装扩展列表）、Snippets（用户代码片段）、UI State（如侧边栏展开状态、活动视图等）。但以下内容不会同步：workspace settings（.vscode/settings.json）、global storage（扩展私有数据，如 Prettier 缓存、GitLens 历史记录）、local history（文件本地修改记录）、SSH 密钥或密码类凭证（VSCode 明确跳过敏感字段）。
多设备冲突时怎么处理？
当两台设备同时修改了同一项设置（比如都改了 editor.fontSize），VSCode 不会自动合并，而是以“最后上传者”为准。解决方式只有两种：
• 手动在其中一台设备上执行 Sync: Reset Sync Data（清空云端状态，再从当前设备重新上传）；
• 或运行 Sync: Show Conflicts 查看差异，逐项选择“Accept Incoming”或“Accept Current”。特别注意：extensions.json 冲突容易导致某台设备反复卸载/重装扩展——建议保持主力设备为“权威源”，其他设备只做只读同步。
为什么扩展没自动安装？同步后仍显示“未安装”
常见原因有三个：
• 当前设备网络无法访问 marketplace.visualstudio.com（尤其是国内环境，需确认代理或 hosts 是否干扰）；
• 扩展在当前 VSCode 版本不兼容（例如扩展要求 VSCode 1.85+，而设备上是 1.79）；
• 扩展 ID 在不同平台存在变体（如 ms-python.python 在 macOS 和 Windows 上一致，但某些第三方扩展在 Linux 下 ID 可能带 -linux 后缀）。验证方法：打开命令面板 → 运行 Extensions: Show Installed Extensions → 点击右上角 ⋯ → Sync Extensions，观察底部状态栏是否出现“Installing…”提示。若卡住，可手动运行 Extensions: Install Extension 并粘贴扩展 ID 重试。
真正麻烦的不是开启同步，而是理解它只同步“声明”而非“状态”——比如你同步了 prettier.eslintIntegration: true，但没同步 eslint 扩展本身，那这个设置就只是个无效开关。设备间一致性，永远建立在“扩展可用性 + 设置语义匹配 + 网络可达性”三者之上。
