“Better Comments”插件通过语义分级(如!警告、?疑问、TODO待办、FIXME需修复、NOTE说明)实现注释高亮,支持自定义关键词、颜色、样式及正则匹配,并可联动Todo Tree等插件提升效率。

“Better Comments”插件能让你的注释在 VSCode 里一眼就被识别出来,不是靠颜色堆砌,而是靠语义分级——不同用途的注释用不同颜色和图标,读代码时不用猜哪句是临时调试、哪句是待办、哪句是重要提醒。
支持的注释类型和默认标记
插件预设了几类常用语义标签,每种对应固定样式:
- ! 表示警告(黄色背景+感叹号图标),比如 /* ! 这里可能有空指针风险 */
- ? 表示疑问或待确认(蓝色),比如 /* ? 这个参数是否应该支持 null? */
- TODO 表示待办事项(青色+复选框图标),比如 /* TODO: 后续要加单元测试 */
- FIXME 表示需修复的问题(红色),比如 /* FIXME: 时间格式化在 iOS 上不兼容 */
- NOTE 表示补充说明(绿色),比如 /* NOTE: 此逻辑仅适用于 v2 API */
自定义关键词和样式
你可以在设置中搜索 “better-comments.tags”,修改或新增规则。例如:
- 添加
{"tag": "HACK", "color": "#a29bfe", "strikethrough": true},让临时绕过方案带删除线 - 把
TODO的颜色改成紫色,避免和NOTE混淆 - 支持正则匹配,比如
"tag": "XXX.*"可高亮所有以 XXX 开头的注释
配合其他插件提升效率
单独用它已经很实用,但搭配这些插件效果更明显:
- Todo Tree:自动聚合所有 TODO/FIXME 注释,生成侧边导航树
- Comment Anchors:给注释加锚点,快速跳转到关联代码段
- Prettier:确保注释格式统一,避免因空格或换行破坏高亮
基本上就这些。注释不是写给机器看的,是写给人看的——让重点信息浮出来,比写得更多更重要。










