最安全有效的做法是直接修改 settings.json 中的 editor.tokencolorcustomizations。需用 vscode 内置的“inspect editor tokens and scopes”工具精准获取语法作用域（scope），workbench.colorcustomizations 不影响代码高亮；语义高亮优先于词法高亮，但依赖语言服务器和主题支持；生效前提包括正确语言模式、主题未禁用装饰、色值格式规范及 scope 精确匹配。
直接改 settings.json 里的 editor.tokenColorCustomizations 就行，不用动主题文件、不需重启、改错也不会让整个编辑器变灰——这是最安全有效的做法。
怎么查准要改的语法作用域（scope）
靠猜 scope 名字基本会失败，比如 Python 的 self 在 Pylance 下是 variable.language.python，在旧扩展里可能是 support.variable.self.python；JavaScript 的函数名在不同上下文里可能是 entity.name.function.js 或 meta.function.js。
必须用 VSCode 内置工具实时抓取：
- 把光标放在目标词上（例如一个字符串、一个
return、一个类名） - 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS） - 输入并执行
Developer: Inspect Editor Tokens and Scopes - 看面板顶部第一个带语言后缀的 scope（如
string.quoted.double.python），优先选它 - 注意右侧
foreground列显示当前实际颜色，方便你确认是否改对了位置
为什么改了 workbench.colorCustomizations 没反应
workbench.colorCustomizations 只管 UI 元素：侧边栏、状态栏、标题栏、活动栏……它对代码文本本身完全无效。所有语法高亮（关键字、字符串、注释等）都走的是 editor.tokenColorCustomizations 这条路。
常见误操作包括：
- 在设置搜索框里搜“color customization”，结果点进了
workbench.colorCustomizations的编辑入口 - 复制网上过时教程的 JSON 片段，没注意字段层级，把
textMateRules塞到了错误位置 - 加了规则但没写
"editor.tokenColorCustomizations"外层字段，导致整个配置被忽略
正确结构必须是：
{
"editor.tokenColorCustomizations": {
"textMateRules": [
{
"scope": "string",
"settings": {
"foreground": "#E6DB74"
}
}
]
}
}
语义高亮（semanticHighlighting）和词法高亮（textMateRules）谁优先
语义高亮优先级更高。如果你同时开了 "editor.semanticHighlighting": true 并配置了 editor.semanticTokenColorCustomizations，那么对同一语法元素（比如变量名），语义规则会覆盖词法规则。
但要注意前提：
- 当前语言必须有支持语义高亮的语言服务器（如 TypeScript 的 TypeScript Server、Python 的 Pylance）
- 所用主题需包含
semanticTokenColors字段（很多第三方主题不提供，比如 One Dark Pro 旧版） - 若主题不支持，VSCode 会自动回退到 textMateRules，不会报错也不会提示
验证是否生效：临时切到官方 Dark+ (default dark) 主题，再看函数/变量是否随定义位置变化而变色（比如同一个变量在声明处和调用处颜色不同）。
容易被忽略的生效条件
即使 JSON 写对了、scope 也抓准了，颜色仍不出现，大概率卡在这几个细节上：
- 当前文件右下角语言模式不是目标语言（例如打开
.py文件却显示Plain Text） - 配置写在了工作区 settings.json 里，但你打开的是其他文件夹或未启用该工作区
- 用了插件主题（如 Nord、Dracula），而该主题显式禁用了装饰（
editor.decorations: false） - 色值格式不对：必须是
#rrggbb或#rgb，不能写red、rgb(255,0,0)或带 alpha 的#rrggbbaa（部分旧版本不支持） - scope 匹配太宽泛（如只写
string），结果把注释里的字符串也一起改了，反而干扰阅读
最稳妥的做法：每次只改一个 scope、一个颜色、一个文件类型，用 Inspect Editor Tokens and Scopes 实时验证，别贪多。
