vscode 默认不支持 todo 高亮,必须安装 todo highlight 等插件;默认仅匹配 todo 和 fixme,自定义标签需手动配置正则表达式并重启窗口。

VSCode 默认不高亮 TODO,必须装插件
VSCode 自身对 TODO、FIXME 这类注释标签完全无感知,不会加亮、不会汇总、也不会跳转。你看到的“高亮”效果,100% 来自第三方插件 —— 最常用的是 TODO Highlight(作者 wayou),不是内置功能,也不是设置开关能打开的。
常见错误现象:
– 在设置里翻遍 todo 相关选项,改来改去没反应
– 以为启用 editor.suggest.showKeywords 或 workbench.colorCustomizations 就能搞定
– 安装了同名但非主流的插件(比如 Todo Tree 配置不对,效果也不一样)
- 只装
TODO Highlight插件还不够,它默认只匹配TODO和FIXME,不识别XXX、HACK等自定义标签 - 插件启用后,需重启 VSCode 或重载窗口(
Ctrl+Shift+P→Developer: Reload Window),否则不生效 - 如果文件没被 VSCode 当作对应语言打开(比如 .sh 文件被识别成 Plain Text),正则匹配会失效 —— 检查右下角语言模式是否正确
怎么配置自定义标签(如 HACK、BUG、OPTIMIZE)
TODO Highlight 的核心是正则匹配,所有标签都靠 todo.highlight.regexes 控制。默认配置只覆盖两个词,想加别的,必须手动写正则并指定颜色和背景。
使用场景:团队约定用 BUG 标记已知缺陷,或用 OPTIMIZE 标记性能待优化点,但默认不识别,不配置就等于没写。
- 打开设置(
Ctrl+,),搜todo.highlight.regexes,点击Edit in settings.json - 添加类似这样的条目:
"todo.highlight.regexes": { "(//|/\*|











