Peacock颜色不生效？先确认是不是“窗口级着色”没触发

很多朋友刚装上Peacock插件，兴冲冲地准备给项目窗口换个颜色，结果发现标题栏和侧边栏纹丝不动。别急着怀疑插件坏了，真相往往是：插件压根还没被“唤醒”。Peacock的染色机制有个关键前提——你必须手动执行一次Peacock: Change Color命令。这个动作就像按下开关，颜色才会被写入当前窗口的元数据。直接在设置里修改"peacock.color"是没用的，这个字段更像一个“记忆缓存”，只记录你上次选了什么颜色，而不是一个实时生效的染色指令。

下面这几种情况，大概率就是踩中了这个“开关未触发”的坑：

• 在settings.json里改了"peacock.color"的值，但窗口颜色毫无变化。
• 新开一个VSCode窗口（哪怕打开的是同一个项目文件夹），之前设置的颜色消失了。
• 在macOS上，只有活动标签页的边缘变了色，但标题栏还是原样。这时候，记得去检查一下Window: Title Bar Style这个设置，看看它是不是被设成了custom。

颜色怎么自动保存到项目里？靠 .vscode/settings.json，但有前提

想让颜色设置“记住”这个项目，下次打开自动生效？这确实可以做到，但同样有个硬性条件：只有执行过Peacock: Change Color命令的窗口，才会把颜色配置写入当前工作区的.vscode/settings.json文件里。写入的内容很简单，类似这样："peacock.color": "#FF6B6B"。之后，无论是通过这个文件夹还是对应的.code-workspace文件打开项目，颜色都会自动恢复。

不过，这里有几点细节需要特别注意：

• 如果你用的是多根工作区（multi-root workspace），Peacock会对整个窗口进行统一染色，而不会为其中的每个子文件夹单独设置颜色。
• 设置项peacock.preserveColorOnClose设为true，确实能帮你记住颜色，但前提是“这个窗口曾经被手动染色过”。如果从未手动执行过染色命令，这个设置也不会生效。
• 在团队协作的场景下，为了避免状态栏颜色干扰团队统一的UI风格，建议在项目设置里加上"peacock.affectStatusBar": false。

预设色 vs 自定义色：用 Peacock: Change Color from List 更可靠

自己手动输入#ff0000这样的HEX色值，不仅容易拼错，而且很难在不同机器或团队成员间保证完全一致。Peacock其实提供了更优雅的解决方案——使用语义化的预设颜色。插件内置了像dev、test、prod这样的预设名，你只需要调用Peacock: Change Color from List命令，然后从列表里选择即可。这些预设对应的颜色值是固定的，能有效避免因色值偏差导致的视觉混乱。

这种预设颜色的用法，在实际工作中非常实用：

• 环境区分一目了然：本地开发窗口用dev (blue)，测试环境窗口用test (orange)，生产环境相关窗口用prod (red)，扫一眼标题栏颜色就知道自己在操作哪个环境。
• 即使在远程开发（SSH/WSL）的场景下，Peacock也能生效。不过需要注意，在某些桌面环境（如GNOME）下，可能只有窗口边框会变色。
• 想要更炫酷的效果？可以试试Peacock: Change to Gradient命令，输入两个HEX色值（比如#4ECDC4和#FF6B6B），就能实现渐变色标题栏。

多个 VSCode 窗口并存时，颜色管理容易踩的坑

理解Peacock的一个核心逻辑至关重要：它的管理单位是“窗口”，而不是“项目”。这个设计带来了灵活性，也带来了一些需要留意的地方：

• 同一个项目完全可以打开两个窗口，并分别设置成不同的颜色。这在对比不同代码分支，或者同时调试不同配置时特别有用。
• 如果你关闭了一个已经染色的窗口，再重新打开时，颜色可能会丢失——除非你已经启用了peacock.preserveColorOnClose设置。
• 单靠颜色来记忆项目，窗口一多还是容易混淆。一个不错的搭配技巧是使用Window: Set Window Title命令，手动给窗口标题加上前缀，比如[api]配蓝色，[admin]配紫色，双重标识更保险。
• 某些功能强大的主题（例如Material Theme）会重绘标题栏，可能会覆盖Peacock的效果。遇到这种情况，优先检查Window: Title Bar Style这个设置项。

最后，有一个最容易被忽略的关键点：Peacock的颜色只影响窗口容器的UI部分，包括标题栏、活动标签页的边框、侧边栏顶部区域。它完全不会改动编辑器内部的代码高亮或者任何主题颜色。所以，它和workbench.colorCustomizations或editor.tokenColorCustomizations这些设置是并行不悖的。不过，当你使用深色主题搭配一个很浅的Peacock颜色时，标题栏上的文字可能会显得发灰，这通常不是bug，而是系统层面的渲染限制。