Highlight插件配正则可实现跨文件、不重启、语法无关的TODO/FIXME高亮;关键需设scope为comment,regex用"(TODO|FIXME)",style用fill,color用hsl避免主题依赖。

直接用 Highlight 插件配正则,5 分钟内搞定,不依赖语法类型、不挑文件后缀、不重启编辑器。
为什么 Find All 不行
按 Ctrl+F 输入 (TODO|FIXME) 再点 Find All,只是临时界面高亮:关掉查找框就消失;跨文件不生效;无法区分注释里的 TODO 和字符串里的 "TODO: retry"。它没给文本打上任何 scope,主题和其它插件都感知不到。
Highlight 插件怎么配才真正生效
关键不是“能不能高亮”,而是“高亮在哪种上下文里出现”。TODO 必须只在注释中才有意义,所以 scope 必须设为 comment,否则会误中 JSON 字符串、HTML 属性值甚至变量名。
-
regex用"\b(TODO|FIXME)\b":双反斜杠是 JSON 字符串转义要求,\b防止匹配到TODO_LIST或FIXME_X -
scope必须是comment,不能写成comment.line或留空——Sublime 的 scope 匹配是前缀匹配,comment能覆盖comment.line.double-slash.js、comment.line.number-sign.python等所有注释变体 -
style推荐"fill":比"underline"更醒目,尤其在深色主题下 - 颜色值用
hsl(48, 100%, 85%)这类明确值,别用"yellow"——后者依赖主题定义,不一定渲染出黄色
多行注释里有 TODO 怎么办
比如 JavaScript 的 /* TODO: refactor this */ 或 CSS 的 /** FIXME: broken in Safari */,它们的原始 scope 是 comment.block,仍属于 comment 前缀范围,所以上述配置天然支持。不需要额外加 comment.block 条目。
但注意:如果某语言(如 Python)把多行字符串("""TODO""")也标为 comment,就会误高亮。此时得收紧正则,例如改成:
"regex": "^\s*(//|#|/\*|\*|\*/).*?\b(TODO|FIXME)\b"
不过这会牺牲通用性——你得自己权衡是保准度还是保覆盖范围。
颜色太淡或看不见?别碰主题文件
很多人去改 .sublime-color-scheme 里的 region.yellowish,结果没用,因为 Highlight 插件默认不走 region scope,它直接画色块。正确做法是:在插件配置里改 color 值,例如:
-
"color": "hsl(0, 100%, 92%)"(更浅的红) -
"color": "hsla(210, 70%, 70%, 0.3)"(带透明度的蓝,避免遮挡文字)
真正的坑在于:你改了配置却没生效,大概率是 Preferences → Package Settings → Highlight → Settings - User 里漏了最外层大括号,或者 JSON 格式错误导致整个配置被忽略——建议复制粘贴后用在线 JSON 校验器过一遍。

















