VS Code语法高亮需同时满足scope匹配、颜色格式合法、配置层级正确三条件；editor.foreground仅影响未被token规则匹配的文本，真正控制关键字/字符串颜色的是editor.tokenColorCustomizations中的textMateRules，且必须用十六进制或rgba值。
为什么改了颜色还是不明显
直接在 settings.json 里写 "editor.foreground": "#aaa" 却发现关键字还是发灰、字符串几乎看不见——不是颜色没生效，而是你动错了层级。VS Code 的代码颜色由两层叠加决定：主题自带的语法高亮（tokenColors） + 用户覆盖配置（editor.tokenColorCustomizations）。前者定义“哪段是关键字”，后者只负责“给它涂什么色”。如果主题本身把 keyword 设成透明或极低饱和度，你再调 editor.foreground 也救不回来。
- 先确认当前主题是否启用语法高亮：换回
Default Dark+或Light+测试，若颜色立刻正常，说明原主题的tokenColors有缺陷 -
editor.foreground只影响未被 token 规则匹配的文本（比如纯文本文件），对 JS/Python 等语言基本无效 - 真正控制明暗度的是
editor.tokenColorCustomizations里的foreground值，且必须用十六进制（如"#a6e22e"）或 rgba（如"rgba(166, 226, 46, 0.9)"），不能写"lightgreen"
怎么让字符串/注释变暗或变亮
想压低注释亮度减少干扰，或提亮数字常量增强可读性？必须用 TextMate scope 精准命中，不能靠猜。
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入Developer: Inspect Editor Tokens and Scopes，点击代码中任意字符串，右侧弹窗会显示真实 scope（如string.quoted.double.js） - 在
settings.json中添加："editor.tokenColorCustomizations": { "textMateRules": [ { "scope": "comment", "settings": { "foreground": "#888" } }, { "scope": "constant.numeric", "settings": { "foreground": "#ff9600" } } ] } - scope 值必须完全匹配 Inspection 工具输出，常见通用 scope 有
keyword、string、comment、support.function；带语言后缀的（如string.python）优先级更高 - 深色主题下避免用纯白
"#ffffff"做字符串色——对比度过高易疲劳；浅色主题慎用纯黑"#000000"做关键字——边缘发虚
改完颜色却在某些文件失效
同一份 editor.tokenColorCustomizations 配置，在 .js 文件里生效，.ts 文件里却还原成默认色——问题出在语言专属覆盖逻辑。
- VS Code 允许为特定语言单独配色，语法是
"[typescript]": { "editor.tokenColorCustomizations": { ... } }，注意方括号和引号不能少 - 如果只写了顶层
editor.tokenColorCustomizations，它对所有语言生效；但一旦某语言有专属块，顶层配置会被忽略 - 检查右下角状态栏语言名是否正确（如显示
Plain Text而非TypeScript），错误语言模式会导致 scope 完全不匹配 - 远程开发（SSH/WSL）时，
settings.json在本地生效，但插件和主题需在远程环境安装，否则 token rules 无法加载
UI 边界和背景对比度不够怎么办
代码颜色调得再舒服，如果侧边栏文字融在背景里、IntelliSense 提示框边界模糊、标签页分隔线看不见，整体视觉依然吃力。这些不属于语法高亮范畴，得动 workbench.colorCustomizations。
- 加粗所有面板边界：
"workbench.contrastBorder": "#333"（深色主题）或"#ccc"（浅色主题） - 让提示框“浮出来”：
"editorSuggestWidget.border": "#444"，配合"editorSuggestWidget.background": "#252526" - 确保活动标签页可辨识：
"tab.activeBackground": "#2d2d2d"（比编辑器背景稍深） - 别漏掉
editor.inactiveSelectionBackground：切换到终端后，之前选中的代码仍需可见，它和editor.selectionBackground是独立控制的 - 所有值必须是十六进制或 rgba；
rgb()、命名色、hsl() 全部无效，写了也不生效
Inspect Editor Tokens and Scopes 确认目标文本的真实 scope，而不是凭感觉写 string 或 keyword。 
