Todo+插件可提升VSCode中TODO管理能力,支持自定义标签、集中面板查看、筛选跳转及自动归档;需安装插件、配置JSON、编辑标签、启用面板与归档功能。

如果您在VSCode中使用默认的TODO注释功能感到功能有限,无法满足复杂项目中的任务追踪需求,则可能是由于缺乏对TODO项的分类、过滤、标记和持久化管理能力。以下是利用Todo+插件实现更高效TODO管理的操作步骤:
本文运行环境:MacBook Air,macOS Sequoia。
一、安装与基础配置
Todo+插件需通过VSCode扩展市场安装,并启用其核心语法识别与工作区设置,以确保所有支持的语言文件中TODO、FIXME等标签被正确捕获。
1、打开VSCode,点击左侧活动栏的扩展图标(或按快捷键Ctrl+Shift+X)。
2、在搜索框中输入Todo+ by Fabio Spampinato,找到作者为Fabio Spampinato的插件。
3、点击“安装”,安装完成后点击“重载”按钮使插件生效。
4、按下Cmd+Shift+P(Mac)或Ctrl+Shift+P(Windows/Linux),输入并选择“Preferences: Open Settings (JSON)”。
5、在settings.json中添加以下配置项:"todo.timeStamp": true, "todo.showCountInStatusBar": true。
二、自定义TODO标签类型
Todo+允许用户定义任意名称的标签(如HACK、REVIEW、OPTIMIZE),并为每类标签指定颜色、优先级和是否计入统计,从而实现语义化任务分类。
1、按下Cmd+Shift+P,输入并选择“Todo+: Edit Tags”。
2、在弹出的JSON编辑界面中,找到"todo.tags"字段,将其值替换为包含多个对象的数组。
3、每个对象需包含"name"、"color"和"icon"三项,例如:{"name": "REVIEW", "color": "#FFA500", "icon": "eye"}。
4、保存文件后,在代码中添加// REVIEW: 检查边界条件,该行将显示橙色图标并出现在Todo面板中。
三、使用Todo面板进行集中管理
Todo+提供独立侧边栏面板,可实时聚合当前工作区所有匹配的TODO项,支持排序、筛选与快速跳转,避免在多文件间手动查找。
1、点击左侧活动栏底部的TODO图标(或按Cmd+Shift+P后输入“Todo+: Toggle Panel”)。
2、面板顶部点击Filter by Tag下拉菜单,选择仅显示FIXME项。
3、在列表中右键某一项,选择“Reveal in File”可直接定位到源码位置。
4、勾选面板右上角的Show Completed复选框,可查看已打勾完成的任务记录。
四、启用自动归档与完成标记
Todo+支持在任务完成后自动添加时间戳并移至归档区域,保留历史痕迹的同时保持主视图简洁,适用于需要审计或复盘的协作场景。
1、在settings.json中添加配置:"todo.archiveOnComplete": true, "todo.archiveSection": "ARCHIVED"。
2、在代码中将// TODO: 优化循环逻辑修改为// TODO: 优化循环逻辑 [x],插件将自动识别完成状态。
3、保存文件后,该项立即从主Todo面板消失,并追加到当前文件末尾的ARCHIVED注释块中。
4、若需恢复未完成状态,只需删除[x]标记并保存,该项将重新出现在Todo面板顶部。










