TodoReview插件需以项目方式打开文件夹、配置.patterns正则匹配及.pattern_names,并通过TodoReview: Show命令生成可点击跳转的TODO/FIXME清单,缺一不可。

用 TodoReview 插件,不是 ListPaths(这插件根本不存在)。它能真正一键扫描整个项目、生成可点击跳转的清单,且原生支持 TODO/FIXME 等关键词,无需手写脚本或拼凑命令。
为什么不能用 ListPaths?它压根不存在
你在任何主流渠道(Package Control 官方仓库、GitHub、Sublime 官网)都搜不到 ListPaths 插件。所谓“一键列出项目所有文件路径”的教程,要么是把 SideBarEnhancements 的 Copy Paths 功能张冠李戴,要么是混淆了控制台命令。强行安装同名 zip 包,大概率触发 ImportError 或被插件管理器静默忽略——连报错都不给你看。
TodoReview 怎么装和配才不踩坑
安装本身简单,但默认配置容易漏掉关键项:
- 必须通过
Ctrl+Shift+P→Package Control: Install Package→ 输入TodoReview安装,别手动拖 zip - 安装后立刻打开
Preferences → Package Settings → TodoReview → Settings – User - 至少补上
"pattern_names"和"patterns",否则只认TODO,不认FIXME或自定义词 - 推荐最小可用配置:
{ "pattern_names": ["todo", "fixme", "hack"], "patterns": { "todo": "(?i)\b(todo|TODO)\b", "fixme": "(?i)\b(fixme|FIXME)\b", "hack": "(?i)\b(hack|HACK)\b" } }
怎么“一键”生成清单?注意两个关键动作
所谓“一键”,其实分两步,缺一不可:
- 确保项目已加载:必须用
File → Open Folder…打开根目录(左下角显示路径),而不是只打开几个文件;Add Folder to Project…不行,它不触发完整项目扫描 - 调用命令:
Ctrl+Shift+P→ 输入TodoReview: Show→ 回车;侧边栏弹出清单,每条含文件名、行号、内容,点击直接跳转 - 如果只搜当前文件,用
TodoReview: Find TODOs in current file,但这就不是“项目级”了 - 快捷键可自定义,比如加进
Key Bindings – User:[{"keys": ["ctrl+alt+t"], "command": "todoreview"}]
生成的清单为什么点不动?常见断点在哪
清单列出来了,但点击没反应——这不是插件坏了,而是环境链断了:
- 文件路径含中文或空格?TodoReview 在某些 Sublime 版本里会解析失败,临时改路径测试
- 文件没保存?未保存的
untitled标签页不会出现在清单里,哪怕你写了 TODO - 搜索范围被排除规则拦住了:检查
Settings – User里有没有"file_exclude_patterns"或"folder_exclude_patterns",比如"*.log"或"node_modules"—— 如果你的 TODO 恰好写在被排除的文件里,它就直接消失了 - 语法类型被禁用了搜索:极少见,但若某个文件的
Settings – Syntax Specific里有"enable_search": false,TodoReview 就绕不过去
真正麻烦的不是装插件,而是确认项目加载方式、排除规则、文件保存状态这三者是否对齐——漏一个,清单就残缺,还找不到原因。

















