todoreview没反应需检查文件后缀是否在file_patterns中、项目是否在根目录打开、排除node_modules等目录;高亮失效因颜色依赖主题对keyword.other.todo等scope的支持;快捷键应绑定todoreview_show命令。

TodoReview 装完没反应?先确认它真在扫描你的文件
插件装了,命令也执行了,但侧边栏空空如也——大概率是它压根没扫到你写的 TODO。TodoReview 默认只扫常见后缀(比如 *.py、*.js),如果你在 .vue、.ts 甚至自定义配置文件里写了注释,它会直接跳过。
- 进
Preferences → Package Settings → TodoReview → Settings,检查file_patterns是否包含你当前文件的扩展名,例如加一行"*.vue" - 如果项目里有
node_modules或dist目录,记得在folder_exclude_patterns里加上,否则扫描卡顿、结果刷屏 - 确保你是在「项目根目录下」打开 Sublime 的(右键 → “Open with Sublime Text”),否则它可能只扫当前文件,不递归整个工程
为什么 TODO 高亮了,FIXME 却没颜色?关键词匹配不是靠“名字”而是靠正则
很多人以为改 keywords 数组就能让所有词高亮,其实 TodoReview 的高亮逻辑分两层:列表能搜出来 ≠ 编辑器里带颜色。颜色依赖语法作用域(比如 keyword.other.todo),而默认只对 todo 和 fixme 这两个 pattern 启用该作用域。
- 在设置里用
patterns字段明确定义每个词的正则,例如:"fixme": "(?i)\b(FIXME|Fixme|fixme)\b"(注意双反斜杠) - 同时必须把
fixme加进pattern_names列表,否则即使正则匹配成功,也不会触发语法着色 - 大小写敏感?
(?i)必须写在正则最前面,漏掉或写成(?i:FIXME)在某些版本里会失效
高亮颜色太淡 / 完全看不见?别调插件,先看主题支不支持
TodoReview 本身不画颜色,它只是给匹配文本打上 keyword.other.todo 这类 scope 标签;真正决定颜色的是你当前的 color_scheme 文件。很多轻量主题(尤其自定义的 .tmTheme)压根没定义这个 scope。
- 换回默认主题试试:菜单 →
Preferences → Color Scheme → Monokai,如果立刻显色,说明原主题缺配置 - 不想换主题?可以手动补一个 scope 规则:打开
Preferences → Color Scheme → Convert to JSON,在rules数组里加一段:{"scope": "keyword.other.todo", "foreground": "#FF5722"} - 别碰
commentscope 去强行覆盖——那样会让所有注释变色,失去语义区分
快捷键 Ctrl+Alt+T 没用?命令名和绑定方式早变了
网上很多教程还教你在 Key Bindings 里写 "command": "todoreview",但新版 TodoReview 的命令名其实是 todoreview_show,旧写法会静默失败,连报错都不提示。
- 正确绑定方式:
{"keys": ["ctrl+alt+t"], "command": "todoreview_show"} - 不确定命令名?按
Ctrl+Shift+P输入TodoReview,看命令面板里显示的完整名称是什么(通常带_show或_toggle后缀) - Mac 用户注意:
ctrl在 macOS 上实际对应cmd,写成ctrl+alt+t在 Mac 上根本不会触发
TodoReview 的核心价值不在“高亮”,而在“可跳转的全局视图”。颜色只是辅助,真正容易被忽略的是:它不分析语法结构,只做纯文本扫描——所以 // TODO、/<em> FIXME </em>/、# NOTE 全都能抓,但 const TODO = 'task' 这种变量名也会误报。得靠正则的 边界符和上下文排除来收口,不然列表一刷几百条,就没人看了。











