workbench.colorCustomizations写错位置会导致全局污染，必须置于项目根目录.vscode/settings.json并选“工作区设置”，否则默认写入用户级settings.json而影响所有窗口；Peacock插件通过"peacock.color"语义化配置更稳妥，自动处理对比度且一键重置。
workbench.colorCustomizations 写错位置导致全局污染
直接改 workbench.colorCustomizations 却没限定作用域，是最常踩的坑——它默认写进用户级 settings.json（路径如 ~/.vscode/settings.json），一改全变，所有打开的文件夹都跟着变色。
必须确认三件事：
- 右下角状态栏显示「工作区」，不是「用户」
- 配置文件路径是项目根目录下的
.vscode/settings.json，不是用户目录里的同名文件 - VSCode 弹出「在 settings.json 中编辑」时，一定选「工作区设置」；勾选「用户设置」等于白干
远程开发（SSH / Dev Container）下还要额外检查：remote.extensionKind 是否把相关插件设为 ["workspace"]，否则 .vscode/settings.json 可能被忽略。
Peacock 插件比硬写 colorCustomizations 更稳
手动写 workbench.colorCustomizations 容易漏项、配错对比度、重启后失效，而 Peacock 把逻辑封装成语义化字段 "peacock.color"，只注入标题栏、活动栏、状态栏等关键区域，不碰编辑器底层样式，兼容性高得多。
装好插件后，只需在工作区 .vscode/settings.json 里加一行：
"peacock.color": "#4ECDC4"
或者更稳妥地用预设值：
-
"peacock.color": "dev"（开发环境蓝调） -
"peacock.color": "prod"（生产环境红调）
它自动处理文字/图标对比度，比如深背景配浅文字、浅背景配深图标，不用手动调 activityBar.foreground。重置也简单：Peacock: Reset Color 一键清空，不留残留。
只设 editor.background 是视觉割裂的根源
很多人只改 "editor.background"，结果侧边栏、标签页、活动栏还是原主题色，整个界面像拼凑出来的——因为 VSCode 不继承编辑器背景到其他 UI 区域。
要真统一，必须显式补全这些关键项：
"sideBar.background""tab.activeBackground"-
"activityBar.background"（别设"#ffffff"，会吞掉图标；推荐"#f8f8f8"） "statusBar.background"
如果启用了自定义标题栏（window.titleBarStyle 设为 "custom"），还得加 "titleBar.activeBackground"，否则标题栏颜色不一致。
tokenColorCustomizations 高亮性能比 theme 文件更轻量
想微调语法颜色（比如让 strings 更亮、comments 更灰），优先用 editor.tokenColorCustomizations，而不是换整个 theme 文件。
原因很实在：
- theme 文件（.json 或 .tmTheme）要完整加载并解析全部 token 规则，启动慢、内存占用高
-
editor.tokenColorCustomizations是增量覆盖，只改你列出来的几项，VSCode 直接注入 CSS 变量，无解析开销 - 它不依赖语言扩展，对 TypeScript/Python/Go 等所有支持 TextMate scope 的语言都生效
示例配置（只动三处，不影响其他语法）：
"editor.tokenColorCustomizations": {
"strings": "#A6D608",
"keywords": "#FF6470",
"comments": "#608B4E"
}
注意：scope 名称必须准确，比如 "string" 不生效，得用 "string.quoted.double" 才匹配双引号字符串——查 scope 的快捷键是 Ctrl+Shift+P → Developer: Inspect Editor Tokens and Scopes。
真正麻烦的从来不是怎么配色，而是配完之后不知道哪一层在起作用、改了 A 区域却影响了 B 区域、重启后颜色消失——这些都不是配置本身的问题，而是作用域和加载时机没理清。
