Peacock不会自动上色，必须手动执行“Peacock: Change Color”命令才能生效；颜色仅作用于当前窗口，且写入工作区.vscode/settings.json后下次打开同路径才复现。
Peacock 不会自动给不同项目上色，必须手动触发 Peacock: Change Color 命令，颜色才写入当前工作区的 .vscode/settings.json 并在下次打开时复现。
为什么装完 Peacock 没反应？
插件安装后默认完全静默——不自动染色、不改任何 UI 元素。常见误判场景：
- 以为“装完就生效”，其实要先按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Peacock: Change Color才启动着色 - 改了
peacock.color字段却没生效，是因为该配置项只是缓存值，不能驱动渲染；真正起作用的是命令执行动作 - macOS 用户看不到标题栏变色，大概率是
Window: Title Bar Style设成了native，需设为custom
颜色怎么保存？是否随项目一起打开？
颜色配置会自动写进当前工作区根目录下的 .vscode/settings.json，例如：
{ "peacock.color": "#FF6B6B" }
只要下次是通过打开该文件夹（或 .code-workspace 文件）启动 VSCode，颜色就会加载。但注意：
- 新开一个独立窗口（哪怕打开同一路径），默认无色，仍需手动运行
Peacock: Change Color - 多根工作区（multi-root workspace）中，整个窗口视为一个单位，不会按子文件夹分别着色
-
peacock.preserveColorOnClose设为true只影响“关闭再开同路径”时的恢复行为，前提是该窗口曾被手动染色过
团队协作时要不要提交 .vscode/settings.json？
可以提交，但需权衡：
- 提交
"peacock.color"能让所有成员打开项目时看到统一标识色，适合区分 dev/test/prod 环境 - 但 VSCode 会同时写入
"workbench.statusBar.background"等衍生配置，可能干扰团队统一主题策略；建议加"peacock.affectStatusBar": false抑制状态栏着色 -
.vscode/目录常被.gitignore排除，若要提交，需显式取消忽略：在项目级.gitignore中删掉.vscode/，或全局配置里排除它（如git config --global core.excludesfile ~/.gitignore_global）
颜色选不好？对比度/兼容性问题怎么解？
深色主题下浅色 Peacock（如 #ffeb3b）容易导致标题栏文字发灰，这不是 bug，是系统渲染限制。实用对策：
- 优先选饱和度高的亮色，比如
#ffd740比#ffeb3b更清晰 - 避免用纯灰阶色（如
#cccccc），与默认主题太接近，失去区分意义 - 某些主题（如 Material Theme）重绘了标题栏，可能遮盖 Peacock 效果；此时检查
Window: Title Bar Style是否为custom - Linux 桌面环境（如 GNOME）可能强制统一标题栏样式，此时只能依赖侧边栏顶部和活动标签页边缘变色
最易被忽略的一点：Peacock 的颜色是窗口级元数据，不是配置轮询结果。它不监听 settings.json 变化，也不会因为文件被 git revert 就自动回退——你得手动运行 Peacock: Reset Color。
