最有效方法是用developer: inspect editor tokens and scopes实时抓取目标代码的精确scope，再在settings.json中配置editor.tokencolorcustomizations.textmaterules；若无效，需检查是否被语义高亮或第三方主题覆盖。
直接改 textMateRules 最有效，但 90% 的人卡在 scope 没抓准、规则没生效或被语义高亮绕过——不是配置写错了，是根本没对上 VSCode 真正识别的 token。
怎么确认你要改的代码片段对应哪个 scope
别猜作用域名，也别搜“VSCode 注释颜色怎么改”。VSCode 不认这种模糊描述。必须用内置工具实时抓取：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并执行Developer: Inspect Editor Tokens and Scopes - 把光标停在目标位置：比如一个
if、一对[]、一段//行注释、甚至某个变量名 - 左下角弹出面板会立刻显示完整的 scope 链，例如：
keyword.control.js、punctuation.bracket.square、comment.line.double-slash - 优先选最具体的 scope（如
string.quoted.double.js而非笼统的string），避免跨语言误配
editor.tokenColorCustomizations 配置必须写对位置和格式
这个配置只在 settings.json 中生效，不是 UI 设置界面，也不是主题文件里。常见失效原因全是路径或语法问题：
- 打开命令面板，执行
Preferences: Open Settings (JSON) - 在顶层 JSON 对象内添加字段：
"editor.tokenColorCustomizations"，值是一个对象，不是数组 - 必须用
textMateRules字段，每条规则含scope和settings，例如：
{
"editor.tokenColorCustomizations": {
"textMateRules": [
{
"scope": "keyword.control.js",
"settings": {
"foreground": "#ff6b6b"
}
}
]
}
}
- 引号必须是英文双引号；末尾不能多逗号；
scope字符串大小写敏感；settings里只支持foreground、background、fontStyle（如"italic"或"bold italic"）
为什么改了 keyword 却不影响 TypeScript 里的 class 名
因为 keyword 这类通用 scope 在 JS/TS 中基本不用于类名——它归语义高亮管。传统语法高亮（TextMate）只能识别词形，而 class MyClass 中的 MyClass 是由语言服务器识别为 support.class 或更细粒度的语义 token（如 class）。
- 若想单独调类名颜色，得用
editor.semanticTokenColorCustomizations，且确保"editor.semanticHighlighting": true - 语义规则优先级高于 TextMate 规则，所以即使你写了
"scope": "support.class"在textMateRules里，也可能被覆盖 - 查语义 token 类型仍要用
Developer: Inspect Editor Tokens and Scopes，但注意面板里会同时显示 “TextMate scopes” 和 “Semantic token type + modifiers” 两栏 - 常见语义类型：
class、function、parameter、variable、interface；修饰符如.declaration、.defaultLibrary
第三方主题导致自定义失效的典型表现和解法
你配好了 textMateRules，重启也没变色？大概率是主题自带的 tokenColors 或 semanticTokenColors 把你的规则压掉了。
- 现象：改了
string颜色，但实际还是主题原来的青绿色；或者只在某些文件生效（比如 .js 里变了，.ts 里没变） - 查法：在
Developer: Inspect Editor Tokens and Scopes面板里看 “Source” 列，它会明确写出当前颜色来自哪个主题或设置项 - 解法一（推荐）：换一个轻量主题（如 VS Code 自带的
Default Dark+），先验证你的规则是否真能生效 - 解法二：查该主题文档，看是否有禁用其语法层的开关，比如
nord.enforceSyntaxHighlighting设为false，或oneDarkPro.colorfulTokens关掉 - 解法三：不用
textMateRules，改用主题扩展方式，在themes/xxx-color-theme.json的tokenColors数组里追加规则——这样优先级更高，但需手动发布/重载
真正难的不是写规则，而是分辨此刻编辑器到底在用哪套识别逻辑：是 TextMate 正则匹配出来的 keyword，还是 LSP 推出来的 function.declaration，又或者两者叠加后被某个主题悄悄 override 了。每次调色前，务必点开那个 inspect 面板，看一眼 source 和 scope 链——这是唯一不会骗你的依据。
