必须用vscode-highlight插件配正则实现语法级高亮:highlight.regexes需置于settings.json根级,正则双反斜杠转义如"(//TODO)",filterLanguageRegex设为空字符串,并确认语言模式非Plain Text。

怎么让 TODO/FIXME 这类标签真正“跳出来”
默认注释是灰色的,// TODO 和 // NOTE 在视觉上毫无区别,扫一眼根本抓不住重点。靠人眼识别效率低,还容易漏掉关键标记。必须让它们在语法层面就具备独立样式,而不是等你手动搜索。
最直接有效的方案是用 vscode-highlight 插件——它不依赖语言服务,纯靠正则扫描,所以能在 JS、TS、Python、Shell 等任意文件里生效。但配置稍有不慎就会失效:
-
highlight.regexes必须写在settings.json根层级,不是嵌套在某个插件字段下 - 正则要双反斜杠转义:
"(\/\/TODO)"才匹配//TODO,写成"(//TODO)"会解析失败 - 每条规则的
filterLanguageRegex建议显式设为""(空字符串),否则某些语言模式下会意外跳过 - 如果高亮没出现,先确认右下角语言模式不是
Plain Text——这是 70% 失效的根源
为什么 Better Comments 插件有时颜色不对
Better Comments 开箱即用,但它的预设样式和你的主题、当前语言作用域存在隐性冲突。比如你在 Vue 文件里写 // !IMPORTANT,结果没变红,大概率不是插件坏了,而是 Volar 没正确注入 comment.tag 作用域。
解决方法不是重装插件,而是检查作用域是否真实存在:
- 光标停在
// !IMPORTANT上,按Ctrl+Shift+P输入Developer: Inspect Editor Tokens and Scopes - 看输出中
scope字段是否包含comment.tag或类似结构;如果没有,说明语言服务没把这行识别为“带标签注释” - 此时需在
settings.json中补一条editor.tokenColorCustomizations规则,直接匹配comment或punctuation.definition.comment作用域 - 别用太宽泛的 scope,比如只写
comment,否则会影响所有注释;优先选comment.line.double-slash.js这类带语言后缀的
如何避免自定义高亮被主题覆盖
改完 editor.tokenColorCustomizations 发现颜色没变?不是配置没生效,而是 VSCode 主题本身通过 textMateRules 覆盖了你的设置。尤其深色主题(如 One Dark Pro)常把 comment 强制设为 #6272a4,你写的 #ff6b6b 直接被忽略。
真正起效的方式是:用更具体的作用域 + 更高优先级的规则:
- 用
Developer: Inspect Editor Tokens查到完整 scope 链,例如comment.line.double-slash.tsx punctuation.definition.comment.tsx - 在
textMateRules中写成数组:["comment.line.double-slash.tsx", "punctuation.definition.comment.tsx"] - foreground 值加透明度,比如
"#ff6b6bA0",避免在暗色背景上刺眼或发虚 - 不要碰
workbench.colorCustomizations,它只管 UI 元素,对代码文本无效
多关键词高亮时颜色怎么不打架
highlight-words 支持多个词不同颜色,但默认配置下容易“串色”:比如你设了 TODO 红、FIXME 黄,结果 FIXME 在 TODO 附近也泛红——这不是 bug,是正则匹配顺序和捕获组权重导致的。
关键控制点在 highlight.regexes 的书写顺序和分组逻辑:
- 规则按数组顺序执行,越靠前的越优先匹配;把精确度高的放前面,比如
"(\/\/FIXME)"在"(\/\/TODO)"前 - 每个正则必须用括号包裹整个匹配项,否则
settings不生效 - 若想支持
// TODO(my-feature)这种带括号的,正则得写成"(\/\/TODO\([^)]*\))",注意括号和反斜杠都要转义 - 避免用
.*?这类贪婪匹配,大文件里会拖慢响应;能用字面量就不用通配符
复杂项目里,highlight.regexes 的维护成本其实高于 vscode-highlight 的简单正则——真要长期管理几十个标签,不如拆成多个小规则,每条只盯一个语义,反而稳定。


















