vscode注释功能可提升开发效率与代码可维护性，支持自动生成TODO列表、高亮自定义标签、扩展增强及快捷键操作。1. 内置TODO、FIXME、NOTE识别，通过问题面板或全局搜索快速定位任务。2. 在settings.json中配置todo.tags，为HACK、REVIEW等自定义标签添加颜色高亮。3. 安装Todo Tree和Better Comments扩展，实现树状任务视图与注释样式分类。4. 使用Ctrl+/、Shift+Alt+A快捷键切换注释类型，并创建带用户名与时间戳的代码片段模板。合理运用这些功能有助于团队协作与个人管理。

VSCode 的注释功能不只是用来写普通备注，它支持多种高级用法，比如自动生成 TODO 列表、高亮特定标签、自定义注释关键字等，能显著提升代码可维护性和开发效率。

1. 自动生成 TODO、FIXME 等任务列表

VSCode 内置了对常见注释关键词（如 TODO、FIXME、NOTE）的支持，可以通过“问题面板”或搜索功能快速查看所有待办事项。

操作方法：

• 在代码中添加注释，例如：
  // TODO: 优化性能
  // FIXME: 修复边界条件错误
  // NOTE: 此函数仅用于调试
• 打开“问题”面板（菜单栏 → 查看 → 问题），VSCode 会自动识别这些标签并列出。
• 也可以使用全局搜索 Ctrl+Shift+F，输入 TODO 或 FIXME 快速定位。

2. 自定义注释标签和高亮样式

你可以通过设置让 VSCode 识别自定义关键词，并为其添加颜色高亮和提示。

配置步骤：

• 打开设置（Ctrl+,），搜索 “todo”。
• 进入 Todo: Keywords 设置，点击“在 settings.json 中编辑”。
• 添加自定义标签，例如：

{ “todo.tags”: [ { “text”: “HACK”, “backgroundColor”: “#FF5370”, “foregroundColor”: “#FFFFFF” }, { “text”: “REVIEW”, “backgroundColor”: “#FFCB6B”, “foregroundColor”: “#000000” } ] }

保存后，代码中的 HACK 和 REVIEW 注释就会有醒目背景色。

智标领航

专注招投标业务流程的AI助手，智能、高效、精准、易用！

117

查看详情

3. 使用扩展增强注释功能

官方功能有限，可通过插件实现更强大的注释管理。

推荐扩展：

• Todo Tree：实时扫描并以树形结构展示所有 TODO 类注释，支持正则匹配、图标标记、文件跳转。
• Better Comments：根据前缀样式区分注释类型，例如：
  /// 表示重要说明
  !! 表示警告
  ? 表示疑问待确认

4. 快捷键与代码片段提升效率

结合快捷键和用户代码片段，可以快速插入结构化注释。

• 选中文本后按 Ctrl+/ 可快速切换行注释。
• 使用 Shift+Alt+A 切换块注释。
• 创建用户代码片段（Snippets），例如定义 todo 模板：

“Insert TODO with timestamp”: { “prefix”: “todo”, “body”: [ “// TODO(${env:USERNAME}): ${CURRENT_HOUR}:${CURRENT_MINUTE} – $1” ], “description”: “插入带用户名和时间的 TODO” }

输入 todo 后回车，自动插入格式化的 TODO 注释。

基本上就这些。合理利用 VSCode 的注释机制，能让团队协作更清晰，个人开发更有条理。不复杂但容易忽略。