VSCode插件无法同步的主因是未启用Toggle Extension Sync开关、extensions.json未真实写入、新设备未手动刷新扩展面板，且官方同步已停服，必须使用Shan Khan版Settings Sync插件配合GitHub Gist手动操作。
VSCode插件无法同步，不是同步功能“坏了”，而是三个关键开关没打开、路径字段被静默跳过、或你根本没在用当前有效的同步机制——2023年底起官方 Settings Sync 已停服，现在必须用 Settings Sync 扩展（Shan Khan 版）配合 GitHub Gist，且所有操作都得手动触发。
Sync: Toggle Extension Sync 必须手动启用
插件列表默认不参与同步，即使你登录了 GitHub、上传过配置，extensions.json 也可能是空的或只含占位符。这不是权限问题，是开关压根没开。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Sync: Advanced Options - 选
Toggle Extension Sync，确认状态变为 enabled - 再运行
Sync: Upload Settings，此时extensions.json才会写入真实插件 ID（如ms-python.python） - 新设备运行
Sync: Download Settings后，插件仍显示 “Not Installed”，需手动点扩展面板右上角刷新按钮，或执行Extensions: Install Extensions from VSIX
settings.json 里这些字段会被静默过滤
同步时 VSCode 会自动跳过含机器依赖的绝对路径字段，不报错、不提示，但会导致 Python 解释器失效、终端崩溃、代理丢失等“功能正常但就是不工作”的诡异现象。
- 典型被过滤字段：
python.defaultInterpreterPath、terminal.integrated.profiles.windows、http.proxy、telemetry.enableTelemetry - 想显式排除某行？在该配置项上方加注释：
// @sync false，例如："python.defaultInterpreterPath": "/usr/local/bin/python3", // @sync false
-
workbench.colorTheme这类 UI 设置不会随settings.json同步——它属于独立的UI State同步项，必须在首次开启同步时手动勾选启用
插件 Location 字段决定是否真同步
同步成功 ≠ 插件已安装。VSCode 严格区分插件来源：Location: Sync 表示该插件由云端控制；User 是本地手动装的，不会上传也不会被覆盖；Workspace 则完全不参与同步。
- 打开命令面板，运行
Developer: Show Running Extensions - 检查目标插件（如
ms-python.python）的Location列：只有显示Sync才算真正纳入同步流 - 如果它是
User，说明你在本机用code --install-extension或拖拽安装过——需在已同步的设备上重装一次，或改用Extensions: Install Extension from VSIX…方式安装 - 注意：
settingsSync.ignoredSettings数组只能屏蔽设置项，不能改变插件的Location类型
同步状态栏显示 “Synced” 不代表配置一致
左下角灰色云图标只是告诉你“上一次上传/下载动作完成了”，不代表当前状态和远端一致。改了快捷键、装了新插件、更新了代码片段，都必须手动上传；另一台设备也得手动下载——没有后台监听，没有实时推送。
- 每次修改后，务必运行
Sync: Upload Settings（不是自动的） - 新设备要生效，必须运行
Sync: Download Settings（不是点一下就同步） - 不确定同步内容是否完整？运行
Settings Sync: Show Synced Data，确认Extensions、Keybindings、User Snippets这三项都打了勾 - 最常被忽略的一点：
.vscode/settings.json（工作区级配置）天然不同步，这是设计使然，避免项目设置污染全局环境
