最常见原因是配错作用域或写到错误配置项；VSCode语法高亮只响应editor.tokenColorCustomizations，非workbench.colorCustomizations；需用开发者工具检查真实scope，确认语言模式正确，并注意语义高亮优先级更高。
为什么改了 editor.tokenColorCustomizations 没反应
最常见原因是配错了作用域（scope）或写到了错误的配置项里。VSCode 的语法高亮颜色只响应 editor.tokenColorCustomizations，不是 workbench.colorCustomizations——后者管的是侧边栏、状态栏这些 UI 元素，对代码行内任何 token 都无效。
另一个高频问题是 scope 太宽泛或太模糊。比如只写 "scope": "keyword"，可能同时匹配到 if、function、const，但不同语言下它们的实际 TextMate scope 并不相同（keyword.control、storage.type、keyword.declaration）。盲目覆盖会导致意外变色甚至丢失语义区分。
- 务必先用
Developer: Inspect Editor Tokens and Scopes（Help → Toggle Developer Tools → 右键代码 → Inspect Editor Tokens）查真实 scope - 优先选带层级的 scope，例如
support.type.python比support.type更安全 - 确认当前文件右下角语言模式正确（如 Python 文件不能是 “Plain Text”）
- 检查是否被第三方主题的
semanticTokenColors覆盖——语义高亮优先级高于 TextMate 规则
如何精准修改 Python 的 self 或类型注解颜色
默认 Python 扩展只做基础语法高亮，self、类型参数（如 str 在 def f(x: str) 中）、装饰器等都属于语义着色范畴，必须开启语义高亮并确保 Pylance 正常工作。
单纯靠 textMateRules 很难单独捕获 self：它在语法层就是普通 identifier，只有语义分析才能标记为 variable.language.self.python 这类 token。
- 确认已安装
ms-python.pylance（不是ms-python.python单独运行） - 在
settings.json中启用："python.languageServer": "Pylance"和"pylance.semanticTokens": true - 全局开启：
"editor.semanticHighlighting.enabled": true - 想自定义语义 token 颜色，用
editor.tokenColorCustomizations.experimentalSemanticTokens，例如：
"editor.tokenColorCustomizations": {
"experimentalSemanticTokens": {
"variable.language.self.python": { "foreground": "#FF6B6B", "fontStyle": "italic" },
"type.parameter.python": { "foreground": "#4ECDC4" }
}
}
string 和 comment 颜色改了但没生效？检查这三点
字符串和注释属于基础语法元素，按理说改 textMateRules 就该立刻见效。如果没变，大概率卡在这三个环节：
- 语言模式识别失败：右下角显示 “Plain Text” 或 “JSONC”，而不是目标语言（如 JavaScript、CSS），
stringscope 根本不会触发 - scope 名称拼错：CSS 里字符串是
string.quoted.single.css，不是string；JS 中模板字符串是string.template.js，单引号是string.quoted.single.js - 主题强制覆盖：某些精简主题（如 Minimal Theme）会清空所有 TextMate 配置，只保留
semanticTokenColors。临时切回Dark+测试是否恢复
推荐写法（兼容多数语言）：
{
"scope": ["string", "string.quoted"],
"settings": { "foreground": "#E6DB74" }
}
自定义高亮后性能变卡？别硬塞一堆 textMateRules
每条 textMateRules 都会增加编辑器 tokenization 阶段的匹配开销，尤其当 scope 是正则或通配符（如 entity.*）时，VSCode 要对每个 token 做多次比对。大文件滚动、输入延迟、光标跳转卡顿，往往就源于此。
- 避免使用
.*、^.*$类正则 scope，优先用确定的静态 scope 名 - 一条 rule 覆盖多个 scope 比写多条 rule 更高效，例如：
["keyword.control.js", "keyword.control.ts"] - 不用的 rule 及时删掉，尤其是调试时临时加的
support.*全局覆盖 - 语义高亮（
semanticTokens）虽然更准，但依赖语言服务器实时分析，大型项目中建议关掉非必要语言的editor.semanticHighlighting.enabled
真正影响可读性的从来不是颜色数量，而是对比度与一致性。改三四个关键 scope（keyword、string、comment、function）通常就够用，再多反而容易互相干扰。
