Better Comments 扩展通过颜色与图标区分注释语义,提升可读性与协作效率;支持安装扩展、自定义标签颜色、选用预设主题、配置语言支持四种方式。

如果您在使用 VSCode 编写代码时希望注释更具可读性与语义区分度,则可能是由于默认注释样式单一、缺乏视觉层次。Better Comments 扩展通过为不同语义的注释赋予特定颜色与图标,显著提升代码审查与协作效率。以下是启用并配置该扩展的多种方式:
本文运行环境:MacBook Air,macOS Sequoia。
一、安装 Better Comments 扩展
该方法通过 VSCode 官方扩展市场直接获取插件,确保版本兼容性与安全性,适用于绝大多数用户场景。
1、打开 VSCode,点击左侧活动栏中的扩展图标(四个方块组成的图标)。
2、在扩展搜索框中输入 Better Comments,回车确认。
3、在搜索结果中找到作者为 aaron-bond 的扩展,点击“安装”按钮。
4、安装完成后,点击“重新加载”以激活扩展功能。
二、手动配置注释关键字与颜色
该方法允许用户自定义注释前缀及其对应颜色,满足团队规范或个人编码习惯,支持精细控制视觉语义。
1、按下 Cmd + ,(macOS)打开设置界面。
2、在右上角点击“打开设置(JSON)”图标,进入 settings.json 文件编辑模式。
3、在 JSON 对象内添加 "better-comments.tags" 配置项,例如:
4、插入如下结构化数组(注意逗号与括号格式):
"better-comments.tags": [ {"tag": "!", "color": "#FF2D00", "strikethrough": false, "backgroundColor": "transparent"}, {"tag": "?", "color": "#3498DB", "strikethrough": false} ]
三、启用预设主题配色方案
该方法利用扩展内置的主题模板快速应用高对比度、无障碍友好的色彩组合,避免手动调色带来的视觉疲劳。
1、在 VSCode 命令面板中按下 Cmd + Shift + P。
2、输入并选择 Better Comments: Select Theme。
3、从下拉列表中选择 Dark High Contrast 或 Light Soft 等预设主题。
4、确认后,所有已支持语言文件中的注释将立即按新主题渲染。
四、在特定语言中启用注释高亮
该方法解决部分语言(如 Markdown、Shell Script)默认未启用 Better Comments 的问题,确保注释样式全局一致。
1、打开 VSCode 设置(JSON),定位到 "better-comments.languageSupport" 配置项。
2、若该项不存在,则手动添加,值为包含语言标识符的数组。
3、例如为 Markdown 启用:添加 "markdown" 到数组中。
4、保存文件后,在 .md 文件中使用 TODO: 或 FIXME: 即可触发着色。










