vscode 默认不识别 todo 注释,需安装 todo-tree 插件并启用文件监听、合理配置 search.exclude 和正则表达式,才能实现稳定高亮与跳转。

VSCode 本身不内置“TODO 高亮”功能,但通过 todo-tree 插件 + 内置的 search.exclude 和 todo-tree.filtering.useBuiltInSearch 配合,能稳定实现高亮、跳转、全局收集——关键不是装插件,而是避免默认配置把 TODO 当成普通注释忽略。
为什么写 // TODO 没反应?
VSCode 默认只识别部分语言的注释语法,且不主动扫描 TODO 关键字;即使写了 // TODO fix this,也不会加亮或出现在命令面板里。根本原因是:没有启用“TODO 搜索索引”机制。
-
todo-tree插件必须启用,且需在设置中开启todo-tree.general.enableFileWatcher(否则文件修改后不刷新) - 若项目用了
node_modules或dist,要确保search.exclude已排除这些目录,否则搜索卡顿、高亮延迟 - 某些语言(如 TypeScript)需确认
todo-tree.tree.showScanModeButton为true,否则右下角不显示“扫描模式”切换按钮
todo-tree 的核心配置项怎么设才不踩坑?
插件默认用正则匹配 TODO、FIXME 等,但容易漏掉大小写混合或带冒号的变体(如 todo:),必须手动调正则。
- 打开设置 → 搜索
todo-tree.regex.regex,替换为:(//|#|











