插件同步失败≠更新出错，需分开处理：同步仅上传id列表，新设备需手动触发install extensions；平台不兼容插件（如ms-vscode.cpptools）会被静默跳过，须加sync.ignoredextensions排除；extensions.autoupdate必须设为false防版本混乱。
插件同步失败 ≠ 插件更新出错，两者配置独立、行为分离，必须分开处理。
同步插件列表但新设备不自动安装
现象是同步开关已开、账户已登录，但另一台设备启动后插件栏空空如也，或只显示“已启用”却无实际功能。
-
sync.autoDownload必须为true（默认值），否则同步仅记录插件 ID，不触发本地安装 - 检查状态栏右下角云图标是否显示“Syncing…”或“Up to date”，若长期停在“Idle”，说明同步未真正完成
- 运行命令
Sync: Show Summary，确认Extensions条目下Last Sync时间是否更新；若为 “Never synced”，需手动点击云图标 →Upload - 某些插件（如仅限 Windows 的
ms-vscode.cpptools）在 macOS 设备上会跳过安装，但不会报错——这不是失败，而是平台过滤
插件自动升级打乱开发环境稳定性
同步成功后，某台设备重启或后台静默升级了 ms-python.python，结果 Python 调试器断连、pylint 报错找不到模块，而其他设备仍用旧版一切正常。
-
extensions.autoUpdate必须设为false，它和同步无关，专控本地版本变更 - VSCode 不支持在同步中锁定插件版本，降级操作（右键插件 →
Install Another Version…）只作用于当前设备 - 若你依赖特定版本（如
2024.8.1），需在所有设备上手动降级，并将该插件加入sync.ignoredExtensions，避免同步时被覆盖回最新版 - 禁用自动更新后，可用命令行批量检查：
code --list-extensions --show-versions，比对各设备输出
跨平台同步时插件反复提示“Unsupported”
你在 Windows 上装了 ms-vscode.powershell，同步到 macOS 后，扩展面板持续显示“Unsupported”，且每次重启都尝试重装。
- 这不是 bug，是 VSCode 主动阻止不兼容插件安装。但反复触发会干扰同步流程
- 把该插件 ID 加入
sync.ignoredExtensions数组（如"ms-vscode.powershell"），它就彻底不出现在同步清单里 - ID 从扩展详情页 URL 获取：
https://marketplace.visualstudio.com/items?itemName=ms-vscode.powershell中的ms-vscode.powershell - 别误加主题类插件（如
dracula-theme.theme-dracula）——它们跨平台通用，忽略反而导致界面不一致
快捷键同步后在新设备上失效
你在 Windows 配了 ctrl+shift+k 删除整行，同步到 macOS 后按同样组合没反应，甚至触发了系统截图。
-
Keybindings默认不参与同步，即使开了 Settings Sync，也得手动进Preferences: Configure Settings Sync勾选它 - 同步后必须运行
Sync: Trigger Sync或点云图标 →Upload，否则keybindings.json不上传 - macOS 的
cmd和 Windows 的ctrl不能强行映射，要用when条件区分："when": "editorTextFocus && isMac"或"when": "editorTextFocus && !isMac" - 冲突常因条件宽泛导致：GitLens 的
ctrl+shift+k绑定可能缺!editorReadonly，而你的自定义加上这个条件就能优先命中
同步本身不解决版本兼容问题，它只保证“装哪些”，不保证“装哪个版本”或“能否运行”。真正稳定的多设备协作，靠的是明确分离同步与更新策略，并对跨平台、不兼容、高风险插件做显式排除——这些动作一旦漏掉一个，就可能让同步变成定时炸弹。
