VSCode主题同步仅传"workbench.colorTheme"字符串会失效，因主题依赖扩展安装与激活；Settings Sync必须勾选Extensions项，否则即使配置同步成功，主题也会回退到Default Dark+。
直接同步 settings.json 里的 "workbench.colorTheme" 值，90% 情况下在新电脑上会失效——主题名只是个字符串，真正起作用的是对应扩展及其资源文件。
为什么只同步 theme 名字会回退到 Default Dark+
VSCode 主题不是内置功能，而是由扩展提供。例如 "workbench.colorTheme": "One Dark Pro" 这个值本身不带任何样式数据，它依赖 zhuangtongfa.Material-theme 或 be5invis.vscode-custom-css 这类扩展已安装并激活。常见错误现象包括：
- 左下角颜色面板中该主题灰显、不可选
- 控制台报错
Unable to load color theme 'xxx' - 设置没变，但打开后自动 fallback 到
Default Dark+
Settings Sync 同步主题必须勾选 Extensions
官方 Settings Sync（登录 Microsoft 或 GitHub 账号）能同步 settings.json、快捷键、代码片段等，但主题生效的前提是：你在启用同步时明确勾选了 Extensions 项。否则，即使 "workbench.colorTheme" 被拉下来，扩展没装，主题照样加载失败。
- 首次同步时 VSCode 会根据
settings.json中的 theme 名反查扩展 ID，再调用code --install-extension自动安装 - 如果某主题扩展已从 Marketplace 下架（如旧版
seti-ui），Sync 会卡住并提示Extension 'xxx' not found - 企业环境禁用 Marketplace 访问时，Sync 无法下载扩展，此时需提前准备离线
.vsix文件
手动备份必须包含 theme 扩展 ID 和 custom CSS 路径
如果你不用 Settings Sync，而是走 Git 或脚本备份路线，光导出 settings.json 和 keybindings.json 还不够。要确保主题还原成功，还得做三件事：
- 运行
code --list-extensions > extensions.txt，确认输出里有主题扩展的完整 ID（比如dracula-theme.theme-dracula，不是Dracula Theme） - 检查
settings.json是否含"vscode_custom_css.imports"，若有，需一并备份其指向的 CSS 文件路径 - 某些主题（如
ayu）还依赖额外字体配置（"editor.fontFamily"），缺了会导致界面失真
跨平台同步时 workbench.colorCustomizations 易被忽略
如果你用了 "workbench.colorCustomizations" 或 "editor.tokenColorCustomizations" 做深度定制，这些 JSON 配置虽然随 settings.json 同步过去，但要注意：
- 部分颜色值在 macOS / Windows / Linux 上渲染效果不同（尤其透明度和 contrast）
- 自定义图标主题（如
vscode-icons）的启用状态不保存在settings.json，而是在扩展自身配置里，需单独确认是否启用 -
"workbench.iconTheme"和"workbench.colorTheme"是两个独立字段，漏同步任一个都会导致视觉割裂
真正决定主题能否跨设备还原的，从来不是那个字符串值，而是扩展 ID + 安装状态 + 自定义资源路径这三者的组合。哪怕 settings.json 一字未改，只要扩展没装或路径不对，就等于没同步。
