vscode内置settings sync默认不自动同步插件，必须手动勾选extensions项并上传；使用settings sync扩展时还需运行toggle extension sync开启插件同步，且每次变更后须手动上传下载，同步仅传输列表不触发安装。
内置 Settings Sync 默认不自动同步插件
VSCode 自 1.63 版本起内置的 Settings Sync 功能，登录 GitHub 或 Microsoft 账户后并不会默认开启插件同步——即使状态栏显示“Synced”，extensions.json 也可能完全没上传或下载。你必须手动勾选「Extensions」这一项，否则另一台设备上永远只有默认插件。
常见错误现象：ms-python.python、esbenp.prettier-vscode 等插件在新设备上始终不出现，命令面板里搜不到，扩展视图空白。
- 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），运行Preferences: Turn on Settings Sync… - 登录后弹出「Choose what to sync」面板，务必勾选 Extensions（其他如 Settings、Keybindings 也建议勾选）
- 首次启用时，选择 Download and merge 而非 Replace，避免本地已装插件被清空
Settings Sync 扩展需手动开关 extension 同步
Shan Khan 的 Settings Sync 扩展（GitHub Gist 方案）比内置功能更透明，但也更“懒”：它默认关闭插件同步，且不会提醒你漏配。即使你已上传过配置，syncExtensions 仍为 false，插件列表根本不会动。
使用场景：企业网络屏蔽 GitHub OAuth、需要细粒度控制同步内容、或内置 Sync 因版本/策略失效时。
- 运行命令面板，输入
Sync: Advanced Options→Toggle Extension Sync，确保状态变为 enabled - 检查
settings.json中是否含"sync.enableExtensions": true（该字段由 Toggle 命令写入） - 每次装/卸插件后，必须手动运行
Sync: Upload Settings；另一台设备要生效，也得手动运行Sync: Download Settings
同步只管“列表”，不管“安装状态”
VSCode 同步机制从不触发实际安装动作。它只上传/下载一个 JSON 列表（如 extensions.json），列出插件 ID 和版本约束。如果某个插件卡在 Installing… 状态，或因网络、权限失败，VSCode 不会重试、不报错、也不降级。
性能影响：大型插件（如 ms-dotnettools.vscode-dotnet-runtime）可能因 CDN 延迟或地区限制导致长时间挂起，但同步流程本身早已结束。
- 同步完成后，打开扩展视图（
Ctrl+Shift+X），点击右上角刷新按钮强制轮询安装状态 - 若某插件始终无响应，手动执行
Extensions: Install Extension，粘贴其 ID（如redhat.vscode-yaml）重试 - 遇到
Unable to install <code>xxx: Error: getaddrinfo ENOTFOUND 类错误，说明插件市场连接失败，需检查代理或换源
敏感路径字段会被静默过滤，不报错也不提示
同步过程会跳过所有含机器依赖的绝对路径字段，比如 python.defaultInterpreterPath、terminal.integrated.profiles.windows、http.proxy。你在 macOS 上配置的 Python 解释器路径上传后，在 Windows 设备上对应字段直接为空，但 VSCode 绝不警告。
容易踩的坑：你以为同步完成了，结果终端打不开、Python 插件报“no interpreter found”、代理失效——全因这些字段被悄悄丢弃。
- 想保留某路径？在
settings.json中该行上方加注释：// @sync false，例如：// @sync false"python.defaultInterpreterPath": "/opt/homebrew/bin/python3" - 工作区级配置（
.vscode/settings.json）天然不同步，这是设计使然，别试图让它同步 - 验证是否完整：运行
Settings Sync: Show Synced Data，确认Extensions、Keybindings、User Snippets三项都打了勾
Synced 字样只代表上一次动作完成，不代表当前状态与远端一致。
