直接修改 editor.tokenColorCustomizations 即可即时生效,无需装主题、写插件或重启;需在 settings.json 顶层添加该字段,内含 textMateRules 数组,每条规则须同时含 scope 和 settings(至少 foreground),scope 必须通过 Developer: Inspect Editor Tokens and Scopes 获取最具体值,避免被主题覆盖或语义高亮拦截。

直接改 editor.tokenColorCustomizations 就行,不用装主题、不用写插件、不重启也能即时生效。其他路径——比如调 workbench.colorCustomizations 或瞎猜 scope ——基本白忙。
怎么在 settings.json 里加 token 颜色规则
打开命令面板(Ctrl+Shift+P 或 Cmd+Shift+P),执行 Preferences: Open Settings (JSON);在顶层 JSON 对象里插入字段:"editor.tokenColorCustomizations",值是一个对象,里面必须含 "textMateRules" 数组。
别写成 "tokens"、"rules" 或塞进 workbench.colorCustomizations 里——VS Code 会静默忽略,不报错也不生效。
-
"textMateRules"是当前推荐写法,兼容性比旧版"comments"/"strings"字段更好 - 每条规则必须同时有
"scope"和"settings",缺一不可 -
"settings"里至少要写"foreground"(颜色),可选加"fontStyle": "bold"或"underline"
scope 怎么拿才准,为什么不能抄网上的示例
别查文档、别猜、别复制“keyword”或“string”这种宽泛词——它们要么匹配太广(拖慢渲染),要么根本不对你当前语言插件生效。
正确做法:把光标停在目标代码上(比如一个 console.log()、一段 // 注释、一个 const),按 Ctrl+Shift+P 输入并执行 Developer: Inspect Editor Tokens and Scopes,看面板顶部第一个 scope。
- 选最上面那条(最具体),比如
support.function.console.js而不是support.function - Python 的
keyword和 TypeScript 的keyword.control.ts完全不互通,混用就失效 - 同一个 token 可能有多个 scope,但只有最靠前的那条会被你的规则命中
为什么改了没反应?三个高频原因挨个查
VS Code 不报错,只沉默跳过。90% 的“不生效”都卡在这三处:
-
scope写错:比如想改注释却写了comment,实际得用comment.line.double-slash(JS/TS)或comment.line.number-sign(Python) - 配置位置错了:不能放在
workbench.colorCustomizations下,也不能写在用户界面设置里,必须是settings.json顶层字段 - 被第三方主题覆盖:One Dark Pro、Nord 等主题自带
tokenColors,会压过你的规则;临时切回Default Dark+测试,或关掉主题的语法强化开关(如"nord.enforceSyntaxHighlighting": false)
颜色值和性能要注意什么
颜色值必须合法:"#e06c75"、"rgba(224, 108, 117, 0.9)" 都行;但 "red"、"lightcoral" 这类命名色不推荐,部分语言插件不认。
性能上,scope 越宽越慢:用 "*" 或 "identifier" 会让大文件渲染明显卡顿;优先选带上下文前缀的,比如 "variable.other.readwrite.ts" 而不是 "variable"。
容易被忽略的是语义高亮层:editor.semanticTokenColorCustomizations 优先级高于 tokenColorCustomizations,如果你开了 "editor.semanticHighlighting": true(TypeScript/Python 默认开),某些 token 可能根本走不到你的 textMate 规则里——这时得去配语义规则,而不是死磕 scope。











