同步插件列表但禁用自动更新是最稳妥策略：sync.autodownload=true确保多设备安装相同插件，extensions.autoupdate=false避免静默升级引发跨平台兼容问题。

同步插件列表但不自动更新版本

跨平台开发时，你真正需要的是「所有设备装相同的插件」，而不是「所有设备都立刻升级到最新版」。VSCode 的 sync.autoDownload 和 extensions.autoUpdate 是两个独立开关，必须分开配置。

常见错误是以为开了同步就等于自动更新——结果在 macOS 上刚配好的 Python 调试环境，切到 Windows 后因为 ms-python.python 自动升了大版本，python.defaultInterpreterPath 失效、调试器连不上。

• sync.autoDownload 设为 true（默认），确保新设备下载 extensions.json 后能自动触发安装（装当前市场最新版）
• extensions.autoUpdate 设为 false，禁用后台静默升级，避免跨平台时因 ABI 或路径差异导致崩溃
• 修改后无需重启，VSCode 会立即生效；但已安装的旧版本不会回退，只影响后续更新行为

手动更新指定插件到兼容版本

某些插件（如 ms-vscode.cpptools、ms-python.python）在不同平台行为差异大，官方可能只发布 Windows 版本，或 macOS 版本滞后。此时不能依赖“全部更新”，得精确控制版本。

VSCode 不支持 settings.json 里写死版本号，但可通过扩展界面降级：

• 在扩展视图中找到目标插件 → 点击右下角齿轮图标 → “Extension Settings” → 关闭 Auto Update
• 右键该插件条目 → “Install Another Version…” → 选一个你验证过跨平台可用的版本（例如 2024.8.1）
• 降级后打开 Developer: Toggle Developer Tools → Network 标签页，确认没有对 marketplace.visualstudio.com 的意外请求（说明没偷偷再拉新版）

注意：这个操作只作用于当前设备；其他设备不会自动继承该版本，除非你在 sync.ignoredExtensions 中排除它，或统一用脚本批量部署。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

跳过平台专属插件和敏感路径配置

同步过程会静默过滤掉含机器依赖的字段和不跨平台的插件，且完全不报错——这是最易被忽略的坑。比如你在 Windows 上配置了 terminal.integrated.profiles.windows，同步到 macOS 后该项直接消失，终端也打不开，但控制台毫无提示。

要主动管理这类内容，有两个层面：

• 在 settings.json 中添加 sync.ignoredExtensions 数组，填入 ID（如 "ms-vscode.powershell"），防止它出现在同步列表里，避免新设备反复尝试安装失败
• 对路径类配置（如 python.defaultInterpreterPath），可在其上方加注释 // @sync false，VSCode 会跳过该行上传
• 工作区级配置（.vscode/settings.json）天然不同步，这是设计使然，别试图把它塞进全局同步里

同步后必须手动触发安装与校验

同步只传 extensions.json 列表，不执行安装动作。即使状态栏显示 “Synced”，新设备上的插件仍处于「已记录但未安装」状态。

典型现象：扩展视图顶部出现 “Recommended extensions” 横幅，或某个插件卡在 Installing…；右下角弹出提示但你不点“Install”，它就不会动。

• 首次下载后，务必手动点击横幅里的 “Install” 或在扩展视图右上角点刷新按钮
• 每次增删插件后，都要运行 Preferences: Sync: Upload Settings（不是“自动上传”，是手动触发）
• 另一台设备要感知变更，也得手动运行 Sync: Download Settings；没有监听、没有推送、没有后台轮询

最容易被跳过的一步：改完 keybindings.json 或新增了一个 snippet，却忘了上传——那新设备永远用不上你调好的快捷键。