插件安装后需手动执行sync: upload settings才能同步到云端，否则新设备仅下载旧列表；首次同步须谨慎选择merge（推荐）或replace；同步不保证安装成功，需检查扩展面板、运行状态及网络环境；路径类配置需加// @sync false注释或改用环境变量。
插件装完不等于同步完成，必须手动上传
VSCode 不会自动把新装的插件写入云端配置——哪怕你已开启 Settings Sync，Sync: Upload Settings 不执行，extensions.json 就永远不会更新。新设备下载时，只会看到旧的插件列表。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并运行Sync: Upload Settings - 输出窗口出现
Successfully uploaded settings才算真正上传成功 - 如果之前没开过插件同步，先运行
Sync: Advanced Options→Toggle Extension Sync，再上传 - 别依赖状态栏的
Synced图标——它只表示上一次动作完成，不是“当前所有变更都已同步”
首次同步选错 Merge/Replace 会导致插件丢失
第一次启用同步或重置 Gist 后，VSCode 会弹出 Merge 或 Replace 提示。这不是可跳过的确认框，选错直接清空本地插件。
-
Merge：保留你当前已装插件，并叠加云端列表 —— 推荐用于已有成熟环境的设备 -
Replace：清空本地插件，只装云端清单里的 —— 适合全新设备或想彻底重置环境 - 如果误选
Replace导致插件消失，立刻在原设备重新上传一次，再在新设备运行Sync: Download Settings - 该选择只影响首次，后续增删插件不再弹窗，靠增量同步
插件同步了但没安装？检查这三处卡点
同步只管“该装哪些”，不管“是否真装上了”。常见现象是扩展面板里显示 Installing… 卡住，或者状态栏提示 Extensions installed 但实际不可用。
- 打开扩展面板（
Ctrl+Shift+X），点击右上角刷新按钮，强制触发安装队列 - 运行
Developer: Show Running Extensions，检查目标插件的Location列是否为Sync—— 若是Local，说明它没走同步路径 - 某些插件（如
ms-python.python、ms-vscode.cpptools）体积大、依赖多，可能因网络中断失败；可手动点击插件右下角的Install按钮重试 - 企业网络若拦截
vscode-sync.trafficmanager.net或marketplace.visualstudio.com，会导致安装静默失败
跨平台插件路径配置会失效，别指望自动修复
像 python.defaultInterpreterPath 这种含绝对路径的字段，Settings Sync 默认跳过；但如果你硬写了又没加注释，它会被同步过去，然后在另一台系统上直接报错。
- 同步前，在
settings.json中对应行上方加注释：// @sync false - 改用环境变量写法，例如：
"python.defaultInterpreterPath": "${env:HOME}/.pyenv/versions/3.11/bin/python" - Windows 特有配置（如
terminal.integrated.profiles.windows）也会被静默过滤，不要尝试强行保留 - 工作区级配置（
.vscode/settings.json）天然不同步——它本就不该同步，应随项目代码一起提交 Git
Sync: Upload Settings 不能省。
