必须安装Highlight插件并配置regex为\b(TODO|FIXME)\b、scope为comment、style为underline或fill,否则无法持久高亮;内置查找仅临时生效,且需启用正则与Find All。

正则高亮TODO必须用插件,内置查找不持久
Sublime Text 原生不支持「自动持续高亮」注释关键词,Ctrl+F 找到 (TODO|FIXME) 只是临时选中,关掉面板就消失。真要让它们一直带下划线或背景色,得靠 Highlight 这类插件——它把正则规则注册进语法渲染流程,每次重绘都生效。
常见错误:装了插件但没改 Settings - User,还用默认空配置;或者正则写成 TODO|FIXME(缺边界符),结果 myTODOvar 也被标红。
- 必须安装
Highlight插件(通过Package Control: Install Package) - 配置里
regex字段要用\b(TODO|FIXME)\b,\b防止匹配到变量名中间 -
scope设为comment,否则代码行里的TODO也会被误标(比如字符串里) -
style推荐"underline"或"fill",别用"outline"——在多数主题下几乎看不见
Highlight插件的正则必须匹配注释上下文
光写 \b(TODO|FIXME)\b 不够,得让它只作用于注释区域。否则 // TODO fix this 和 const TODO = true 全被高亮,反而干扰阅读。
关键在 scope 参数:设成 "comment" 后,插件会先检查当前文本是否属于注释作用域,再应用正则。这个判断依赖 Sublime 的语法分析器——所以你得确保文件已正确识别语法(比如 .js 文件不能被当成 Plain Text)。
- 如果文件右下角显示
Plain text,高亮不会触发,先右键 →Set Syntax → JavaScript - 自定义语言需在
.sublime-syntax中明确定义commentscope,例如:match: '//.*$' scope: comment.line.double-slash - 多行注释(
/* ... */)需额外加一条规则,scope改为comment.block - 部分主题对
commentscope 不着色?换用keyword或invalid临时测试,确认是 scope 匹配问题还是主题缺失
不用插件时,Find All 是最快定位方式
赶时间或受限于环境(比如公司禁装插件),直接用内置查找最可靠。但必须严格按步骤来,少一步就找不到:
grex 是一个命令行工具和库,能够从用户提供的测试用例中自动生成正则表达式。该工具使用 Rust 编写并提供 Python 绑定,可以生成最具体的匹配给定输入的正则表达式,支持 Unicode 16.0、字符类检测、量词表示法和不区分大小写的匹配。
- 按
Ctrl+F(Windows/Linux)或Cmd+F(macOS),确保面板顶部标签是Find,不是Replace - 输入
(TODO|FIXME),然后点右下角.*图标(或按Alt+R),图标变蓝才算启用正则 - 点
Find All,所有匹配项会高亮并出现在侧边栏;再按Alt+Enter可跳转到下一个 - 想搜整个项目?按
Ctrl+Shift+F,Where框必须填路径如./src/**/*.js,空着或只写.会漏子目录
注意:这种高亮不保存,关闭文件或重启 Sublime 就清零——它只是查找状态,不是语法渲染。
高级需求:区分 TODO 和 FIXME 的颜色
如果团队约定 TODO 是待优化,FIXME 是阻塞性 Bug,需要不同视觉提示,Highlight 插件支持多规则并存,但必须拆开写,不能合并在一个正则里。
- 在
highlights数组里加两条独立对象,分别匹配\bTODO\b和\bFIXME\b - 给
TODO设style: "underline"、icon: "dot";给FIXME设style: "fill"、color: "red" -
color值必须是十六进制(如"#ff4444")或 CSS 颜色名(如"red"),不支持主题变量 - 顺序很重要:规则按数组顺序执行,后面规则可能覆盖前面的高亮——把更具体的放前面,比如先
FIXME再TODO
真正容易被忽略的是 scope 绑定粒度:哪怕正则写对了,如果文件没被识别为对应语言,comment scope 就不存在,整条规则等于没写。










