VSCode主题颜色不能通过手动修改CSS文件定制，必须使用workbench.colorCustomizations配置或主题扩展；前者轻量实时，后者灵活系统，但均需遵循官方color token规范。
VSCode 主题颜色不能靠手动改 CSS 文件来定制 —— 它不读你本地的 styles.css，所有颜色必须通过主题扩展或 workbench.colorCustomizations 配置生效。
如何用 workbench.colorCustomizations 覆盖单个颜色
这是最轻量、最直接的方式，适合只想调几个关键色（比如改侧边栏背景、活动标签页高亮）的用户。它不依赖外部主题，修改后实时生效，且不会被主题更新覆盖。
-
Ctrl+,（Windows/Linux）或Cmd+,（macOS）打开设置，点击右上角「打开设置 (JSON)」图标 - 在
settings.json中添加workbench.colorCustomizations对象 - 键名必须是 VSCode 官方定义的颜色 token（如
sideBar.background、tab.activeBackground），值为合法颜色字符串（"#2d2d2d"、"rgba(45,45,45,0.9)"、"transparent"等） - 注意：某些颜色（如编辑器文字色
editor.foreground）会被当前语法高亮主题接管，此处配置可能无效
{
"workbench.colorCustomizations": {
"sideBar.background": "#1e1e1e",
"activityBar.background": "#252526",
"tab.activeBackground": "#2d2d2d"
}
}
为什么直接改 vscode/resources/app/out/vs/workbench/workbench.desktop.main.css 没用
这个路径看起来像“源码 CSS”，但它是构建产物，每次 VSCode 升级都会被覆盖；更重要的是，VSCode 渲染 UI 使用的是 Electron + 动态注入的样式规则，不是静态加载该文件。强行编辑它不仅无效，还可能导致启动失败或界面错乱。
- 升级后该文件重置，你的修改彻底丢失
- VSCode 启动时会校验资源完整性，篡改可能触发安全机制报错
ERR_INVALID_CRX_HEADER类错误 - 即使临时生效，也只影响当前窗口，新开窗口或重载窗口后失效
自定义主题扩展比 JSON 配置更灵活，但也更重
如果你要系统性重定义整套语义颜色（比如让所有“警告”状态统一变橙、所有“错误”统一加下划线），就必须写一个主题扩展。它本质是一个含 package.json 和 themes/*.json 的小插件。
- 主题文件是 JSON 格式，根对象必须有
type: "dark"或"light"，以及colors字段 - 颜色 key 与
workbench.colorCustomizations一致，但可导出为独立扩展，支持发布到 Marketplace 或本地安装 - 调试时用
F5启动 Extension Development Host，避免污染主环境 - 不推荐新手从零写——优先 fork 现有开源主题（如
vscode-theme-onedark），只改colors段
容易被忽略的兼容性陷阱
很多颜色 token 在不同 VSCode 版本中行为不一致。例如：
-
editorBracketMatch.background在 1.80+ 才支持透明度，旧版会忽略rgba() -
list.hoverBackground在启用了"workbench.list.smoothScrolling": true时可能表现异常 - 使用
editorWidget.background覆盖弹出面板背景时，若主题本身设置了widget.shadow，阴影颜色不会自动适配，需一并调整
真要深调颜色，别只盯着 settings.json —— 先查对应 VSCode 版本的 官方 color token 文档，再看当前启用的主题是否已覆盖了你要改的 token。否则，你写的那行 "tab.inactiveForeground": "#888" 可能早就被主题里同名定义压掉了。
