Todo Tree 与 TODO Highlight 组合实现可追踪、可协作、可收敛的代码任务管理
在 VS Code 的插件海洋里，Todo Tree 和 TODO Highlight 这对组合，堪称是真正能落地的代码任务管理系统。它们提供的远不止是“提醒”，而是一套能够追踪、协作并最终推动任务收敛的完整工作流。单独使用任何一个，都容易丢失关键上下文，只有搭配起来，才能发挥最大效力。
Todo Tree 为什么必须配 ripgrep
插件默认使用 VS Code 自带的搜索引擎，但一遇到 node_modules 目录或者大型项目，卡顿、延迟、漏结果的问题就全来了。在实际开发中，扫描速度直接决定了你是否愿意每天点开那个树状视图看一眼。
- 安装 ripgrep：macOS 或 Linux 系统，在终端执行
brew install ripgrep；Windows 用户则可以使用choco install ripgrep。 - 关键配置：安装后，在 settings.json 中加入
"todo-tree.ripgrepArgs": "--max-columns=200 --max-count=1000"。这能有效避免长行内容被截断或者搜索结果数量受限。 - 性能保障：如果不安装 ripgrep，那么
todo-tree.tree.autoRefresh这个自动刷新功能几乎形同虚设——文件保存后，树状图可能不会更新，导致你误以为没有扫描到新的任务项。
TODO Highlight 的关键词匹配容易踩的坑
插件默认只识别全大写的 TODO、FIXME、NOTE。但现实情况是，代码注释里常常混用大小写、冒号、括号和空格，比如 // todo:、/* FIXME (login) */、// BUG#PROJ-123。要兜住所有这些变体，就得靠正则表达式。
- 配置写法：不要简单地向
todoHighlights.keywords里塞字符串，正确的做法是配置成对象数组。例如：{"pattern": "BUG#[A-Z]+-\\d+", "color": "#f56c6c"}。 - 注意转义：这里有个细节陷阱。在 Ja vaScript 字符串里写
\d+，到了 JSON 配置里就必须写成"\\d+"，少一个反斜杠，整个正则就会失效。 - 作用域确认：如果高亮意外出现在字符串或注释之外（比如变量名里恰好有“TODO”），那很可能是因为没有正确启用语言上下文识别。记得添加配置：
"todoHighlights.languages": ["ja vascript", "typescript", "python"]。
两个插件共用时的冲突点
两者都依赖对代码注释的解析，但底层机制不同：TODO Highlight 是编辑器级别的实时语法高亮，而 Todo Tree 是在文件保存后触发扫描。这就导致一个典型问题——你修改了注释并保存文件后，高亮立刻变了，但 Todo Tree 的侧边栏里可能还挂着旧的条目。
- 刷新策略：建议关闭
todo-tree.tree.autoRefresh，转而使用Todo Tree: Refresh Tree命令进行手动触发。这样可以避免“假阴性”（即实际上有任务，但树没更新）。 - 范围统一：务必把 Todo Tree 的扫描范围（通过
todo-tree.filtering.includeGlobs设置）和 TODO Highlight 的作用域（通过todoHighlights.include设置）保持一致。例如，可以都设置为["**/*.ts", "**/*.js", "**/*.py"]。 - 避免冲突：不要同时开启两个插件的状态栏图标功能（比如
todo-tree.highlights.enable和todoHighlights.showInStatusBar），否则 VS Code 右下角的状态栏会“打架”，显示混乱。
说到底，真正的难点不在于配置出效果，而在于让团队所有成员写下的每一个 FIXME 都指向同一个修复动作、同一位负责人、同一个截止时间。插件只是工具载体，统一的语义规范才是整个系统的骨架——例如，规定所有 BUG# 后面必须跟上 Jira 问题 ID，所有 HACK 必须注明日期和替代方案。没有这样的规范，再好的工具也解决不了模糊表达带来的协作混乱。
