Better Comments 插件通过颜色标记、关键字高亮和结构化样式提升注释可读性:TODO(橙)、FIXME(红)、NOTE(浅蓝)、HACK(绿),支持自定义标签与配色,强调简洁、明确、及时清理。

Better Comments 插件能显著提升代码注释的可读性和组织性,它通过颜色标记、关键字高亮和结构化样式,让注释一眼就能传达意图——不是靠多写,而是靠写得更聪明。
用颜色区分注释类型
插件默认识别常见前缀并赋予不同颜色: • TODO(橙色)标出待办事项,适合记录后续要补的功能或修复点 • FIXME(红色)突出必须修正的问题,比如临时绕过的 bug • NOTE(浅蓝色)说明设计选择或上下文背景,帮助新人快速理解 • HACK(绿色)标记非常规但必要的实现,提醒他人谨慎修改
自定义关键字与配色
你可以在 VS Code 设置中搜索 “better-comments.tags”,添加自己的标签。例如:
• 加入 {"tag": "REVIEW", "color": "#9C27B0", "strikethrough": false},用紫色高亮需团队评审的逻辑
• 把 DEBUG 设为黄色背景+黑色文字,方便在调试阶段快速定位临时日志
保持注释简洁有力
颜色再丰富,也救不了冗长模糊的注释。Better Comments 的价值在于放大有效信息,所以建议: • 每行注释只说一件事,避免堆砌多个 TODO 或混用 FIXME 和 NOTE • 用动词开头,比如 “Refactor this loop after v2.1” 比 “Need to change something here” 更明确 • 删除过期注释——定期搜索 TODO/FIXME 并清理,否则颜色反而会干扰判断
基本上就这些。它不改变你写注释的习惯,只是让好习惯更容易被看见、被理解、被跟进。










