VSCode 官方设置同步需满足三前提：版本≥1.62、通过“Sign in to Sync”登录Microsoft/GitHub账户、首次启用时手动勾选同步项；同步内容含设置、扩展、快捷键等，但不含工作区配置、本地任务、调试配置及敏感凭证。
VSCode 官方已原生支持设置同步（Settings Sync），无需插件或第三方服务，只要登录同一 Microsoft 或 GitHub 账户即可跨设备自动同步：设置、扩展、键盘快捷键、用户代码片段、UI 布局（如侧边栏可见性）、工作台颜色主题 —— 但不包括工作区配置（settings.json 中的 "workbench.*" 以外的 workspace 级设置）、本地任务、调试配置或敏感凭证。
启用同步前必须确认的三项前提
很多“同步失败”问题其实卡在这三步上：
- VSCode 版本 ≥ 1.62（检查方法：
Help → About，查看版本号；旧版需升级） - 已通过
File → Account → Sign in to Sync...登录 Microsoft 或 GitHub 账户（注意：不是 VSCode 的“登录账户”，而是明确点击“Sign in to Sync”） - 首次启用时，VSCode 会弹出「Choose what to sync」面板 —— 必须手动勾选要同步的类别（默认不全选），尤其容易漏掉
Keybindings和User Snippets
如何手动触发同步或解决“不同步”现象
同步不是实时秒级的，且可能因网络、权限或本地冲突静默失败。遇到新设备没拉到配置，按顺序排查：
- 检查状态栏右下角是否显示
Sync: On（灰色表示关闭，蓝色表示开启）；点击它可手动Turn on Settings Sync或Sync Now - 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），运行Developer: Toggle Developer Tools，在 Console 标签页中搜索sync，看是否有Failed to fetch或Unauthorized错误 - 若提示
Conflict detected：说明本地与云端设置存在不可自动合并的差异（例如同一扩展在两台设备启用了不同版本），此时需手动选择“Accept Incoming”或“Accept Local”
哪些内容不会被同步？必须手动处理
同步机制有明确边界，以下内容完全不参与同步，需自行维护：
-
settings.json中标记为"workbench.settings.applyToAllProfiles": true以外的 profile 级设置（即仅对当前用户 profile 生效的配置） - 所有工作区级设置（
.vscode/settings.json），即使该文件被 Git 跟踪，也不会经由 Settings Sync 传播 - 本地任务定义（
.vscode/tasks.json）、调试配置（.vscode/launch.json）、推荐扩展列表（.vscode/extensions.json） - 自定义字体路径、本地 shell 路径（如
terminal.integrated.shell.windows）、SSH 连接信息等含设备强依赖的配置
{
"editor.fontSize": 14,
"files.autoSave": "onFocusChange",
"workbench.colorTheme": "One Dark Pro",
"extensions.ignoreRecommendations": true
}
同步本身足够稳定，但真正麻烦的是混合使用多账户（比如一台用 GitHub、另一台误登 Microsoft）、或在企业环境里启用了策略禁用同步（sync.enabled 被组策略设为 false）。这类情况不会报错，只会静默失效 —— 最快验证方式是换一个干净用户目录启动 VSCode（code --user-data-dir=/tmp/vscode-test），再试一次登录同步流程。
