VSCode中editor.tokenColorCustomizations无效，主因是规则未置于textMateRules数组下、scope不精准或被语义高亮覆盖；须用Developer: Inspect Editor Tokens and Scopes获取真实作用域，并确保每条规则含scope和settings且格式正确。
为什么 editor.tokenColorCustomizations 改了没反应
不是 scope 写错，就是配到了错误的位置。VSCode 的语法高亮只认 editor.tokenColorCustomizations 下的 textMateRules，写进 workbench.colorCustomizations 完全无效——后者管的是侧边栏、状态栏这些 UI 元素，对代码行内 token 零影响。
常见失效点：
- 语言模式识别失败：右下角显示 “Plain Text” 或 “JSONC”，而不是目标语言（如
python、javascript） - scope 太宽泛：比如只写
"keyword"，实际在 Python 里是keyword.control.if.python，在 TypeScript 里可能是keyword.control.return.ts，盲目覆盖会误染其他语言 - 被语义高亮盖掉：Pylance 或 TypeScript Server 开启
semanticTokens后，variable.language.self.python这类 token 优先走语义路径，textMateRules不生效
怎么拿到真正起作用的 scope
不能靠猜，必须用 VSCode 自带的实时探测工具。光标停在你想改色的词上（比如一个 self、一个 async、一段双引号字符串），然后：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS） - 输入并执行
Developer: Inspect Editor Tokens and Scopes - 看面板顶部第一个带语言后缀的 scope，例如
variable.language.self.python或keyword.control.async.js
优先选最具体的那个——它通常最长，也最可靠。右侧 foreground 列会显示当前颜色，方便你确认是否改对了位置。
textMateRules 的正确结构和写法
textMateRules 必须是数组，每条规则是独立对象，且必须同时包含 scope 和 settings。格式稍有偏差就整个不生效。
关键约束：
-
scope可以是字符串或字符串数组，但不能是正则、通配符或变量 -
settings只支持foreground、background、fontStyle（值只能是"italic"、"bold"或"bold italic"） - 不支持
fontSize、border、opacity等 CSS 属性 - 多条规则按 scope 字符串长度做最长前缀匹配，所以
string.quoted.double.js会覆盖string
示例（改 Python 中 self 为红色斜体）：
{
"editor.tokenColorCustomizations": {
"textMateRules": [
{
"scope": "variable.language.self.python",
"settings": {
"foreground": "#FF6B6B",
"fontStyle": "italic"
}
}
]
}
}
想单独高亮 TODO/FIXME 注释怎么办
基础注释作用域（如 comment）太宽，直接改会影响所有注释。要精准捕获 TODO:，得先定义语法层匹配规则，再赋予专用 scope。
步骤分两步：
- 创建自定义
.tmLanguage.json文件（或通过扩展注入），用正则匹配\bTODO:\s.*，并设name为comment.todo.python - 在
editor.tokenColorCustomizations.textMateRules中加一条规则："scope": "comment.todo.python"
注意：VSCode 默认不提供 TODO: 的专用 scope，必须自己造；否则只能退而求其次，用 comment.line.number-sign.python 这类已有 scope 做粗粒度控制。
语义层面无法覆盖这类标记——它们纯属词法构造，跟类型、定义位置无关，别指望 Pylance 或 TS Server 能帮你打上特殊 token。
