接手一个老项目,满屏 // TODO 和 // FIXME,翻半天找不到重点。同事甩来一个插件列表,装了五个,注释颜色互相覆盖,反而更乱。

只想让关键字变色

Better Comments 够用。它默认把 TODO、!、?、// 分成四类颜色,还能在 settings.json 里加自己的标记。配置项叫 better-comments.tags,每项有 tag、color、backgroundColor、strikethrough。比如给「注意」配个橙色,团队里谁都能看懂。

要把待办集中起来

Todo Tree 在侧边栏列出所有 TODO、FIXME,点一下跳过去。它扫描整个工作区,大项目第一次索引会卡几秒。可以在设置里限定 todo-tree.general.tags,再加 todo-tree.filtering.excludeGlobs 排除 node_modules 和 dist,不然列表里全是依赖包的注释。

大文件里做书签

Comment Anchors 支持 ANCHOR、SECTION、LINK 几种标记,长文件里能直接跳到某一段。它和 Todo Tree 的标记语法有重叠,同时开可能重复高亮,选一个就够。

装之前先看维护状态

扩展商店里不少注释插件两三年没更新,VSCode 升级后高亮失效。看详情页的最后更新时间、issue 数量和安装量,比看评分靠谱。公司内网机器装不了扩展,也可以在 settings.json 里用 editor.tokenColorCustomizations 改注释颜色,效果差一点,但不用联网。

中文标记也能用,把 tag 写成「待确认」「临时方案」,搜索时直接搜中文,比英文缩写好认。注意 tag 是前缀匹配,写太短会误伤普通注释。同一个人装三款高亮插件,颜色规则按加载顺序生效,后装的覆盖先装的。

注释高亮是给读代码的人省时间,不是为了截图好看。团队里统一两三个标记,比每人一套颜色更实用。