editor.tokenColorCustomizations是唯一能直接精准控制代码语法颜色的配置项，必须在settings.json顶层用textMateRules配合Developer: Inspect Editor Tokens and Scopes获取的精确scope（如keyword.control.ts）设置foreground，避免被第三方主题覆盖或写错位置。
editor.tokenColorCustomizations 是唯一能直接、精准控制代码颜色的配置项，其他任何设置（比如 editor.foreground 或 workbench.colorCustomizations）对语法高亮都无效。
怎么确认当前代码用了哪个 scope
别猜、别查旧文档、别复制网上的“通用 scope”——90% 都不匹配你正在用的语言插件和 VSCode 版本。
- 把光标停在目标代码上（比如一个
const、一段// 注释、一对{}） - 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac），输入并执行Developer: Inspect Editor Tokens and Scopes - 看弹窗顶部第一个 scope（最具体那个），例如
keyword.control.ts而不是笼统的keyword - 不同语言插件注册的 scope 完全不同：Python 的
string和 TS 的string不互通，support.function.console.js在 .ts 文件里根本不会命中
怎么写有效的 tokenColorCustomizations 规则
editor.tokenColorCustomizations 必须是 settings.json 顶层字段，结构固定，且只接受十六进制或 rgba 值。
- 正确写法：
"editor.tokenColorCustomizations": { "textMateRules": [ { "scope": "comment", "settings": { "foreground": "#888" } } ] } -
scope支持字符串或数组，但必须完全匹配 Inspection 工具输出（大小写、点号、后缀都不能错） -
settings里必须带foreground字段，不能只写{"foreground": ""}或漏掉settings层 - 避免宽泛 scope：
identifier会拖慢大文件渲染；string会同时影响 JS/TS/JSON/HTML，应优先用string.quoted.double.js - 颜色值必须合法：
#e06c75、rgba(224, 108, 117, 0.9)可以；red、rgb(224,108,117)部分语言插件不认
为什么改了却没反应？三个高频原因
VSCode 不报错，只沉默忽略。排查顺序比重装插件快得多：
-
scope写错了：比如写了comments（少个点）或comment.line（实际是comment.line.double-slash），必须用 Inspection 工具实时取 - 配置位置错了：塞进了
workbench.colorCustomizations对象里，或写在了用户界面设置 GUI 中，而不是settings.json顶层 - 被第三方主题覆盖了：One Dark Pro、Nord 等自带
tokenColors，会压过你的规则；临时切回Default Dark+测试，或关掉对应开关（如"nord.enforceSyntaxHighlighting": false）
深色/浅色主题下容易被忽略的对比度陷阱
语法高亮再准，颜色选错照样伤眼。这不是主观偏好，而是可测量的视觉问题：
- 深色主题慎用
#ffffff做字符串色——与背景对比度过高（>21:1），长时间阅读易疲劳 - 浅色主题避免用
#000000做关键字——边缘发虚、有光晕感，尤其在非 Retina 屏上 - 注释色太亮（如
#aaa）会抢内容注意力；太暗（如#444）又难识别——建议用#777~#999区间 - 真正需要验证的是 WCAG AA 标准（≥ 4.5:1），可用 WebAIM Contrast Checker 输入背景色 + 字符串色实测
