直接写"comments":"#xxx"无效，因VSCode主流主题已弃用该旧字段，必须用textMateRules数组匹配精确scope（如comment.line）并设foreground十六进制色值，再重启窗口生效。
VSCode 里改注释颜色，editor.tokenColorCustomizations 配置必须用 textMateRules + 精确 scope，写 "comments": "#xxx" 基本无效——这是最常卡住的地方。
为什么直接写 "comments" 不生效
VSCode 的 editor.tokenColorCustomizations 中的 "comments" 键是旧版兼容写法，仅在极少数基础主题（如早期 Default Light）中起作用。当前主流主题（One Dark Pro、Nord、Monokai Pro 等）全部使用 TextMate scope 机制着色，"comments" 被完全忽略。
- 你写的
"comments": "#ff6b6b"在 settings.json 里不会报错，但也不会渲染到任何注释上 - 主题内置规则优先级高于
"comments"，哪怕你换回 Default Dark+，新版也已弃用该字段 - 真正起效的是
textMateRules数组里的"scope"匹配，比如"comment"或"comment.line"
怎么查注释真实 scope（关键一步）
不同语言、不同注释形式（//、#、/* */、<!-- -->）底层 scope 完全不同。不能靠猜，必须实测。
- 把光标停在任意一行注释上（比如 JS 的
// todo或 Python 的# hello） - 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS） - 输入并运行
Developer: Inspect Editor Tokens and Scopes - 看右上角弹出面板中 “Scope” 列表：最上面那个（如
comment.line.double-slash.ts）就是你要匹配的精确 scope
常见 scope 示例：comment（通用）、comment.line（所有行注释）、comment.block（块注释）、punctuation.definition.comment（某些主题把注释符号单独归类）
正确配置 textMateRules 修改注释色
在 settings.json 顶层添加或合并 editor.tokenColorCustomizations，结构必须严格：
"editor.tokenColorCustomizations": {
"textMateRules": [
{
"scope": ["comment", "comment.line"],
"settings": {
"foreground": "#569cd6"
}
}
]
}
-
scope可以是字符串或字符串数组，支持多 scope 同时匹配 -
foreground必须是十六进制（#rrggbb或#rgb），不支持rgb()、命名色（red）或变量引用（editor.foreground） - 改完保存后，需执行
Developer: Reload Window（Ctrl+Shift+P→ 输入该命令），热更新不可靠 - 若只针对某语言（如只改 TypeScript 注释），应配合语言限定：
"[typescript]": { "editor.tokenColorCustomizations": { ... } }
第三方主题导致配置失效怎么办
很多流行主题（如 One Dark Pro、Material Theme）默认启用语义高亮（Semantic Highlighting），它会动态覆盖 TextMate 规则，导致你的 textMateRules 被静默忽略。
- 先临时切换到 VSCode 自带主题（如
Default Dark+），验证配置是否真能生效 - 确认是主题干扰后，在设置中搜索对应主题配置项，例如：
oneDarkPro.enableSemanticHighlighting设为false - 部分主题提供专属开关，如 Nord 主题需设
nord.enforceSyntaxHighlighting为false - 更彻底的做法：在
textMateRules里用更细粒度 scope（如comment.line.double-slash.ts）强行匹配，绕过语义层
真正麻烦的不是写错配置，而是 scope 没对上、主题锁死了语法层、或者 language mode 没识别准——这三处不排查清楚，改十次 settings.json 都白搭。
