TODO Tree 插件用于快速发现、定位和管理代码中的 TODO、FIXME 等标记注释,以树形结构展示匹配行,支持自定义关键词、多级折叠、跳转、高亮及正则匹配,并可通过配置优化使用体验。

VSCode 的 “TODO Tree” 插件不是帮你记待办事项的,而是帮你**快速发现、定位和管理代码里所有 TODO、FIXME、XXX 等标记注释**——它不创建任务,只让散落在成百上千行代码里的待办线索一目了然。
它到底能帮你看到什么?
默认情况下,它会扫描整个工作区,把符合规则的注释行(比如 // TODO: 重构登录逻辑 或 /* FIXME: 空指针未判空 */)提取出来,以树形结构展示在侧边栏。支持的关键词可自定义,不止是 TODO —— 你加个 NOTE 或 HACK,也能让它列出来。
- 支持多级折叠:按文件夹、文件、甚至关键字分组
- 点击树中任意条目,自动跳转到对应代码行
- 右键可快速在编辑器中高亮当前文件的所有 TODO
- 支持正则匹配,比如识别 // TODO(username): 这类带责任人格式
怎么让它真正好用?关键在配置
开箱即用能工作,但想让它贴合你的习惯,得调几个核心设置。打开 VSCode 设置(Ctrl+,),搜 todo-tree,重点关注:
- Todo Tree > General > Enable: true —— 确保插件已启用
- Todo Tree > Default Tags —— 改成你团队实际用的标签,例如 ["TODO", "FIXME", "HACK", "NOTE"]
- Todo Tree > Advanced > Highlight —— 开启后,源码里的 TODO 行会带背景色或边框,一眼就能扫到
- Todo Tree > Filter > Globs —— 排除 node_modules、dist 等目录,避免干扰
和 Git 提交前检查联动(进阶技巧)
很多人写完代码顺手加个 // TODO: 后续补单元测试,结果一发布就忘了。你可以配合 pre-commit hook 或 CI 脚本做简单拦截:用命令行运行 grep -r "TODO\|FIXME" ./src --include="*.ts" --include="*.js",如果有输出就提醒检查。虽然 TODO Tree 本身不参与提交流程,但它让你日常开发中随时看见这些“隐患”,自然降低遗漏概率。
基本上就这些。不用额外记事本,也不用切换页面——待办就在代码旁边,点一下就过去,改完再刷新,树就干净了。










