vscode同步需明确github账户、1.75+版本及五项同步内容，否则登录无响应、插件/快捷键丢失；同步非实时双向，须手动上传下载，且敏感配置和工作区设置天然不参与。
VSCode 设置同步不是“开个开关就自动全通”，必须明确账户类型、版本门槛和同步范围三要素，否则大概率卡在登录后没反应、新设备拉不到插件、或快捷键丢失。
Settings Sync 必须用 GitHub 账户登录，Microsoft 账户可能不生效
VSCode 内置的 Settings Sync 功能默认走 GitHub OAuth 流程，哪怕你用 Microsoft 账户登录了 VSCode 主体，同步仍会失败——因为后台实际依赖的是 GitHub 的 gist 权限。常见现象是点击 Preferences: Turn on Settings Sync… 后跳转空白页或反复重定向。
- 打开命令面板（
Ctrl+Shift+P或Cmd+Shift+P），输入并运行Preferences: Turn on Settings Sync… - 务必选择 GitHub 登录，不要选 Microsoft；授权时必须勾选
gist（用于存储配置）、user:email和read:user三项权限 - 检查 GitHub 的 Personal Access Token 是否过期：访问
Settings → Developer settings → Personal access tokens，确认 token 存在且含gist权限 - 企业网络若拦截
gist.github.com，可临时切手机热点测试；也可在 VSCode 设置中搜索sync.gist，确保其值为空（非空表示被手动改过，需删掉）
首次启用必须手动勾选 Keybindings 和 User Snippets
VSCode 不会默认全选同步项，尤其 Keybindings（快捷键）和 User Snippets（自定义代码片段）常被漏掉，导致新设备上 Ctrl+P 没反应、自定义模板消失。
- 登录成功后，弹出的
Choose what to sync面板里，至少勾选这五项：Settings、Extensions、Keybindings、User Snippets、UI State - 如果某台设备已装好特定扩展（比如只在 Windows 上用的
ms-vscode.cpptools），可在另一台 macOS 设备开启同步时，主动取消勾选Extensions，避免被降级或冲突 -
UI State控制侧边栏展开状态、编辑器分组布局等，不勾选会导致每次打开都是默认单面板
多设备同步不是实时双向，需手动触发上传/下载
VSCode 不会监听本地 settings.json 变更后自动推送到云端，也不会在后台静默拉取远程更新。你改了设置、装了插件，其他设备不会立刻感知。
- 修改配置后，务必手动运行
Preferences: Sync: Upload Settings（上传）或Preferences: Sync: Download Settings（下载） - 状态栏右下角点击云朵图标，可快速查看当前同步状态，或直接点
Sync Now - 遇到
Conflict detected提示时，VSCode 不会自动合并：例如两台设备分别启用了不同主题，它会列出差异项，你得逐条选“接受传入”或“保留本地” - 扩展同步依赖
extensionId，若某扩展在 Linux 不可用，VSCode 会跳过它，但不会报错或提醒
敏感字段和工作区配置天然不参与同步
VSCode 对同步内容做了硬性过滤，不是你没配对，而是机制上就排除——比如本地 Python 解释器路径、代理设置、SSH 配置、所有 .vscode/settings.json 内容，都不会上传。
- 以下字段一律不被同步：
python.defaultInterpreterPath、http.proxy、terminal.integrated.shell.windows、workbench.colorTheme（注意：这个是用户级，能同步；但workbench.settings.applyToAllProfiles以外的 profile 级设置不行） - 项目级调试配置（
.vscode/launch.json）和任务（.vscode/tasks.json）完全不进 Settings Sync 流程，必须靠 Git 版本控制或符号链接维护 - 想让某工作区设置跨设备一致？别指望同步，应把它挪到用户级
settings.json中，前提是该设置不带绝对路径或平台强依赖
最易被忽略的一点：同步状态栏图标变灰 ≠ 同步失败，它只表示“未检测到新变更”；真正要确认是否生效，得看 Preferences: Sync: Show Sync Status 里的时间戳，以及扩展列表是否真的刷新了——有时候 UI 显示“已同步”，但 extensions.json 还卡在旧版本，得手动点一次上传再下载。
