VSCode主题配色需三步完成：安装扩展、启用主题、清除干扰配置；Ctrl+K Ctrl+T是原生可靠入口，workbench.colorTheme控制UI而editor.tokenColorScheme决定代码区颜色，终端/预览/调试区需单独设colorScheme，图标主题须独立安装启用。
VSCode 主题配色不会“一键应用”，所谓“一键”实际是三步动作的压缩：装扩展 + 启用主题 + 清除干扰配置。跳过任一环节，界面就卡在半黑半白状态。
Ctrl+K Ctrl+T 为什么比命令面板更可靠
这是 VSCode 原生设计的主题切换入口，不依赖扩展加载缓存，列表实时反映所有已安装且启用的主题。命令面板（Preferences: Color Theme）有时会漏掉刚装完还没刷新的扩展，尤其在远程开发或插件较多时。
- 按
Ctrl+K Ctrl+T（Windows/Linux）或Cmd+K Cmd+T（macOS）后，灰色显示的主题 = 已安装但未启用，直接选中即激活 - 如果列表为空，不是 VSCode 坏了，而是没装任何主题扩展——去扩展市场搜
One Dark Pro或Dracula Official装一个再试 - 部分外接键盘需配合
Fn键，但该组合键本身不依赖功能键，多数情况不用按
代码区还是白的？你只改了 UI，没动语法高亮
workbench.colorTheme 只控制侧边栏、标题栏、标签页等 UI 区域；editor.tokenColorScheme 才决定代码区的背景和文字颜色。两者必须同步设置，否则就是“边栏黑、代码白”的割裂视觉。
- 打开
settings.json，确认这两行都存在且值匹配暗色语义："workbench.colorTheme": "Dark+ (default dark)""editor.tokenColorScheme": "Default Dark+" - 第三方主题如
One Dark Pro通常自动绑定tokenColorScheme，但如果你手动写过editor.tokenColorCustomizations或删过这行配置，它可能被覆盖——删掉自定义的tokenColorScheme字段，让主题自己接管 - 改完保存，务必重启 VSCode 或重载窗口（
Developer: Reload Window），否则 token 方案可能不刷新
终端/预览/调试区还发白？它们不继承编辑器主题
VSCode 的终端、Markdown 预览、调试控制台各自有独立主题开关，不会随 workbench.colorTheme 自动变色。忽略这点，视觉割裂感比全亮还伤眼。
- 终端：搜索
terminal.integrated.colorScheme，设为Default Dark+；同时检查terminal.integrated.defaultProfile是否启用了支持深色的 shell（如 PowerShell、zsh） - Markdown 预览：默认走浏览器样式，加这一行进
settings.json："markdown.preview.colorScheme": "dark" - 调试控制台：它复用终端配色，只要上面终端设对了，这里一般就同步生效；若异常，检查是否有扩展（如
CodeLLDB）覆盖了调试主题
图标还是方块？图标主题和颜色主题根本不是一回事
文件图标由独立扩展提供，和颜色主题完全解耦。装了 One Dark Pro 不等于图标会变——那是两个不同 ID 的扩展，必须分别安装、分别启用。
- 图标包推荐装
Material Icon Theme（作者 PKief）或vscode-icons（作者 robertohuertasm），别两个都装，会冲突 - 启用方式是
Ctrl+Shift+P→ 输入Preferences: File Icon Theme→ 选非None的项 - 图标不显示最常见原因：
settings.json里有"workbench.iconTheme": null或"workbench.iconTheme": ""，删掉即可 - 工作区级配置（
.vscode/settings.json）优先级更高，如果只在某个项目里图标消失，先查这个文件
真正容易被忽略的是：主题生效后，editor.background 和 editor.foreground 这类顶层颜色项一旦被硬编码进 settings.json，就会覆盖整个语法着色体系，导致字符串、注释、关键字全变成同一灰度。护眼不是靠调暗，而是靠明度差与饱和度压制——比如背景用 #1e1e1e、主文本用 #e0e0e0、注释用 #5c6370，这种细粒度控制只能通过 workbench.colorCustomizations 和 editor.tokenColorCustomizations 安全覆盖，而不是瞎改顶层字段。
