直接安装TODO Highlight插件后需手动配置keywords和languages字段,才能高亮REVIEW/BUG等自定义标记,并支持.vue/.md等文件类型;正则捕获组错误会导致跳转错位。

直接装 TODO Highlight 插件就能用,但默认只认 TODO、FIXME、XXX 这几个词,其他自定义标记(比如 REVIEW、BUG)不会高亮——得手动配规则。
怎么让 REVIEW / BUG 也高亮
插件默认的关键词列表不包含团队常用标记,必须往 settings.json 里加 todo.highlight.keywords 或 todoHighlights.keywords(注意不同版本字段名有差异)。
- 打开命令面板(
Ctrl+Shift+P),输入Preferences: Open Settings (JSON) - 插入如下内容(以
REVIEW和BUG为例):"todo.highlight.keywords": [ {"text": "TODO", "color": "#ff8c00"}, {"text": "FIXME", "color": "#ff3b30"}, {"text": "REVIEW", "color": "#007acc"}, {"text": "BUG", "color": "#ff2d55"} ] - 保存后,所有含
// REVIEW:或# BUG的注释行会立刻按指定颜色高亮 - 如果用的是较新版本插件(如 2026 年发布的),字段名可能是
todoHighlights.keywords,不是todo.highlight.keywords,错一个字母就不生效
为什么某些文件里没高亮(比如 .vue 或 .md)
TODO Highlight 默认跳过非编程语言文件,.vue 单文件组件里的 <script> 块、.md 文件里的代码块都不会被扫描——除非显式放开语言限制。
- 检查
todo.highlight.languages是否存在,若为空或没包含vue、markdown,就补上:"todo.highlight.languages": ["javascript", "typescript", "python", "vue", "markdown"]
- 如果只想在
.vue的<script>区域生效,别只写vue,得确认 VSCode 当前对这个文件的语言模式识别为vue(右下角状态栏看);否则可能识别成html,那就得加html - Markdown 中的代码块默认不触发高亮,因为插件默认只扫描“注释上下文”,而代码块里是字符串字面量——想让它也扫,得改
todo.highlight.include加入"**/*.md",并确保languages包含markdown
高亮了但跳转错位(光标停在 // 上而不是文字开头)
这是正则捕获组没写对导致的。插件靠正则提取关键词后的文本内容作为跳转锚点,如果正则把注释符号也包进去了,光标就落偏了。
- 检查
todo.highlight.regex或todoHighlights.regex配置项(如有自定义) - 默认正则通常是
/(\/\/|#|


















