TodoReview 无反应的主因是未以项目方式打开文件夹且缺少 .todoconfig 文件;关键词匹配需用 patterns 正则而非 keywords;高亮需 Highlight 插件或主题支持;扫描慢须配置 file_patterns 和 folder_exclude_patterns。
TodoReview 安装后没反应?先检查项目打开方式和
Sublime Text 的 TodoReview 插件默认只在「以项目方式打开文件夹」时激活,单独打开几个文件或用「Open File」打开单个文件,插件根本不会扫描——这是最常被忽略的启动前提。
必须通过
打开整个项目根目录,不能只是拖入文件
项目根目录下需存在一个空文件
(文件名带点,无后缀),否则插件静默不工作
安装完插件后不用重启 Sublime,但要确保 Package Control 已提前装好;若命令面板里搜不到
,大概率是没打开项目或缺
关键词匹配不到 TODO/FIXME?正则配置比
列表更可靠
很多人改了
就以为万事大吉,结果注释里写
还是不识别——因为默认匹配逻辑只认独立单词(
),而冒号、空格、中文标点会打断匹配。
推荐直接用
配置正则,例如:
表示忽略大小写,
同时兼容英文冒号和中文顿号,
吃掉后面任意空白,匹配更鲁棒
避免把
设为
,除非团队强制全大写规范;小写
在 Markdown 或注释块中很常见
为什么高亮不明显?Sublime 默认不给 TODO 上色,得靠额外插件或主题支持
TodoReview 本身只负责“找”和“列”,不控制颜色。你在代码里看到的灰色 TODO,其实是普通注释色——它没被赋予独立作用域(如
),所以换再好的主题也没用。
仿Sublime和notepad++编辑器效果
仿Sublime和notepad++编辑器效果
下载
最快方案:装
插件,在
里加
如果已用 Monokai、Ayucia 等主题,先试切换主题看是否自带
支持;没有的话,手动改
文件成本高,不建议新手折腾
别指望
的临时高亮替代长期方案——它不持久、不跨文件、不联动跳转
扫描慢或漏文件?重点调
和
默认设置会扫所有文本文件,包括
、
、
下的压缩 JS,不仅卡顿,还堆满无效条目。
在
中明确限定范围:
、
这类后缀必须显式加上,否则 Vue 单文件组件里的
块或 TS 注释全被跳过
如果项目含自定义后缀(如
、
),也得加进
,否则插件压根不读这些文件
真正卡住人的从来不是装不上插件,而是项目没以 Folder 方式打开、缺
、正则没覆盖实际注释格式、或者忘了排除
—— 这几处一错,TodoReview 就等于没装。
.todoconfigFile → Open Folder….todoconfigTodoReview: Show.todoconfigkeywords"keywords": ["TODO", "FIXME"]// TODO: 重构缓存逻辑TODOpatterns{ "patterns": { "todo": "(?i)TODO[::]\s*", "fixme": "(?i)FIXME[::]\s*" }, "pattern_names": ["todo", "fixme"] }(?i)[::]\s*case_sensitivetruetodokeyword.other.todoHighlightPreferences → Package Settings → Highlight → Settings - User{ "highlights": [{ "name": "todo_fixme", "scope": "comment", "regex": "\b(TODO|FIXME)\b", "style": "fill", "color": "hsl(45, 100%, 70%)" }] }keyword.other.todo.tmThemeFind Allfile_patternsfolder_exclude_patternsnode_modules.gitdistTodoReview → Settings{ "file_patterns": ["*.py", "*.js", "*.ts", "*.vue", "*.html"], "folder_exclude_patterns": [".git", "node_modules", "dist", "__pycache__"] }*.vue*.ts.gql.astrofile_patterns.todoconfignode_modules