workbench.colorcustomizations只控制ui控件色，如侧边栏、状态栏、标签页、活动栏及editor.background等编辑器容器色，不涉及代码语法高亮。

VSCode 自定义配色不是“改几个颜色就行”，它分 UI 控件色和语法高亮两套独立系统，必须同时处理，否则视觉会断裂——比如背景变暗了，但关键字还是刺眼的蓝。

workbench.colorCustomizations 覆盖的是哪些颜色？

这个字段只管界面控件，不碰代码本身。它作用于 VSCode 的“壳”，比如侧边栏、标签页、状态栏、活动栏这些非编辑区域，以及 editor.background、editor.foreground 这类编辑器容器色（注意：不是代码里某个 if 或 const 的颜色）。

常见误用现象：

• 改了 "editor.background" 但函数名颜色没变 → 因为那是语法层的事，得去 tokenColors 或 editor.tokenColorCustomizations
• 设置了 "activityBar.foreground" 却没生效 → 检查是否拼错键名，VSCode 对 color ID 大小写和连字符敏感，比如 activityBar.foreground 不能写成 activitybar.foreground
• 自定义后某些元素仍显默认色 → 可能被当前激活主题的 colors 字段更高优先级覆盖，workbench.colorCustomizations 只在用户 settings.json 中生效，不进主题包

editor.tokenColorCustomizations 和 tokenColors 有什么区别？

前者是用户级临时覆盖，后者是主题包级正式定义。两者都控制语法高亮，但加载时机和作用范围不同。

editor.tokenColorCustomizations 写在 settings.json 里，适合快速试色或轻量调整：

Wjs Uploading Video

将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。

下载

• 只支持 comments、strings、keywords 等简写别名，不支持精细 scope，例如无法单独改 keyword.control.if
• 值必须是十六进制字符串（如 "#608b4e"），不支持 rgb() 或命名色
• 若启用语义高亮（"editor.semanticHighlighting.enabled": true），部分 token 可能被语言服务器覆盖，此时需关掉语义高亮或改用 textMateRules

tokenColors 是主题 JSON 文件里的数组字段，用于发布正式主题：

• 每项必须含 scope（如 "support.function.console"）和 settings（含 foreground、fontStyle）
• scope 必须精准匹配 TextMate 作用域路径，可用 Developer: Inspect Editor Tokens and Scopes 实时查看光标处真实 scope
• 支持带 alpha 的十六进制（#RRGGBBAA），比如半透明背景；fontStyle 只接受 "italic"、"bold"、"underline" 单值，不能写 "bold italic"

为什么改了 colors 却看不到效果？

最常见原因是 color ID 错误或作用域未激活。VSCode 的 color ID 不是自由命名的，每个都有固定语义和使用前提。

• tab.inactiveBackground 在单标签页窗口下永远不生效，只有多个 tab 并存时才起作用
• editorLineNumber.foreground 依赖 "editor.lineNumbers": "on"，若设为 "off" 或 "relative"，该颜色就不可见
• statusBar.noFolderBackground 只在未打开文件夹时生效；打开文件夹后，实际使用的是 statusBar.background
• 深色主题下某些 color ID（如 titleBar.activeBackground）可能被操作系统原生标题栏接管，VSCode 渲染无效

如何安全地获取真实 scope 和 color ID？

别猜、别搜、别复制过期博客的示例。VSCode 提供两个内置工具，结果即刻可见：

• 定位语法元素：把光标停在目标代码上（比如一个 fetch() 调用），按 Ctrl+Shift+P（macOS 为 Cmd+Shift+P），运行 Developer: Inspect Editor Tokens and Scopes —— 弹窗里第一行就是当前 token 的完整 scope 链
• 查看所有 color ID：同样打开命令面板，运行 Developer: Generate Color Theme From Current Settings，它会生成一份当前已激活 color ID 的完整快照，包含你正在用的主题里实际生效的 key 列表
• 验证修改是否加载：改完 settings.json 后，不用重启，直接 Ctrl+R（macOS Cmd+R）重载窗口即可生效；改主题 JSON 文件则需通过 Developer: Reload Window 或切换一次主题触发重载

真正容易被忽略的是：VSCode 的颜色系统没有“继承”概念，每个 color ID 都是独立开关。你调暗了 editor.background，但 editor.selectionBackground 仍是默认亮色，选中文本就会突兀发白——这种断裂感，往往比配色本身更伤眼。