VSCode关键词颜色失效的三大原因：scope不匹配、配置位置错误（必须在settings.json的editor.tokenColorCustomizations中）、第三方主题覆盖；需用Developer: Inspect Editor Tokens and Scopes实时查scope并针对性配置。
keyword 颜色改不了？先确认 scope 是不是真的 keyword
你写 "keyword": "#ff4757" 却没生效，大概率是因为 VSCode 实际打给关键词的 scope 并不是泛泛的 keyword。比如 JavaScript 的 if 是 keyword.control.js，Python 的 def 是 keyword.control.python，而 TypeScript 接口里的 interface 可能是 keyword.declaration.ts。
别靠猜或搜“vscode keyword 颜色”，必须用命令实时看：
- 把光标停在目标关键词上（比如一个
return） - 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS） - 输入并执行
Developer: Inspect Editor Tokens and Scopes - 看面板顶部第一个带语言后缀的 scope（如
keyword.control.ts），优先用它
如果看到的是 source 或 text.plain，说明文件根本没被识别为代码——先检查右下角语言模式是否正确，或装对应语言扩展。
配置写在哪儿？editor.tokenColorCustomizations 必须进 settings.json
所有语法颜色配置只在 settings.json 里生效，UI 设置界面、workbench.colorCustomizations、主题文件里写都无效。
打开命令面板 → 输入 Preferences: Open Settings (JSON) → 在顶层对象里加字段：
{
"editor.tokenColorCustomizations": {
"textMateRules": [
{
"scope": "keyword.control.ts",
"settings": {
"foreground": "#e06c75",
"fontStyle": "bold"
}
}
]
}
}
注意几个硬性细节：
-
scope字符串大小写敏感，不能写成KEYWORD - JSON 必须合法：全英文双引号，末尾不能多逗号
- 不要用扁平写法（如
"keywords": "#xxx"），它不支持细粒度控制，且容易被忽略 - 若同时配 JS 和 TS，建议用语言前缀隔离，避免互相干扰：
"[javascript]": { ... }
为什么改了还是灰色？第三方主题正在偷偷覆盖你
很多流行主题（如 One Dark Pro、Nord）自带完整的 tokenColorCustomizations 规则，它们的优先级高于你的设置。你写的规则不是失效了，是被压在底下没机会执行。
查证方式：在 Developer: Inspect Editor Tokens and Scopes 面板右侧看 foreground 值，点它旁边的齿轮图标，会跳转到当前生效的颜色定义来源——大概率指向某个主题的 package.json。
解决办法取决于主题：
-
One Dark Pro：设"oneDarkPro.sematicHighlighting": false -
Nord：加"nord.enforceSyntaxHighlighting": false - 不确定时，临时禁用主题，确认你的配置能生效后再逐个开回来
语义高亮（semanticTokenColorCustomizations）也受同样机制影响，但它的作用域更窄，仅当语言服务器返回了对应 token 才触发。
想只高亮特定关键词（比如 TODO）？得用注释 scope + 正则匹配
VSCode 原生不支持“只为某个单词着色”，但你可以借力 TextMate 的 scope 继承和正则能力实现近似效果。
比如让所有 // TODO 显示红色，而不是整行注释：
- 先用
Developer: Inspect Editor Tokens and Scopes点在TODO上，通常得到类似comment.line.double-slash.js的 scope - 再观察
TODO是否被单独切分——多数语言不会，所以需配合自定义语法扩展或插件 - 更现实的做法：把
TODO当作注释中的关键字处理，配一条更具体的 rule：
{
"scope": ["comment.line.double-slash.js", "comment.line.number-sign.python"],
"settings": {
"foreground": "#e06c75"
}
}
这会统一高亮所有双斜杠或井号开头的注释行，比单字匹配更稳定。真要精准到词，就得写 .tmLanguage.json 规则或用插件（如 Todo Tree）。
真正难的从来不是加一行配置，而是搞清那一行该加在哪、加给谁、谁又在背后把它悄悄盖住——scope 不对、位置错了、主题抢了权，三者任一出问题，颜色就卡在灰白之间不动。
