真正高亮需绑定语法scope而非临时界面标记,因Find All仅视觉暂存、不跨文件、不被主题识别;Highlight插件通过scope="comment"、双反斜杠转义正则及fill样式实现持久化语义高亮。

为什么直接搜 TODO 不算真正高亮
按 Ctrl+F 输入 (TODO|FIXME) 并点 Find All,只是临时界面标记,关掉查找框就消失;它不改变文本的语法 scope,也不跨文件生效,更不会被主题颜色规则识别。真正“高亮”意味着让编辑器把 TODO 当作一类有语义的标记(比如 keyword.other.todo),才能和配色方案联动、在侧边栏任务列表里出现、被 Git 工具过滤——这些都依赖 scope,不是视觉暂存。
Highlight 插件配 scope 和 regex 是最稳路径
装完 Highlight 后,在 Preferences → Package Settings → Highlight → Settings - User 里写配置,关键三点必须对齐:
-
scope必须设为comment,否则会误匹配字符串字面量里的"TODO" -
regex要用双反斜杠转义单词边界:"\b(TODO|FIXME)\b"(JSON 字符串里单个会被吃掉) -
style推荐"fill",比"underline"更易扫视;color值用hsl()或#十六进制都行
示例配置片段:
为跨境电子商务生成多语言、SEO 优化的产品描述。支持英语、西班牙语、俄语和阿拉伯语,并针对不同搜索引擎(Google / Bing、Yandex、中东市场)进行专项 SEO 优化。适用于以下场景:用户需为国际市场创建符合 SEO 规范的产品文案、批量生成产品描述,或针对特定搜索引擎及区域用户偏好优化内容。
{
"highlights": [
{
"name": "todo_fixme",
"scope": "comment",
"regex": "\b(TODO|FIXME)\b",
"style": "fill",
"color": "#ffcc00"
}
]
}不同语言注释的 scope 差异会影响匹配效果
JavaScript 的双斜杠注释 scope 是 comment.line.double-slash.js,Python 是 comment.line.number-sign.python,但 Highlight 的 scope: "comment" 是父级通用 scope,能覆盖绝大多数情况。如果发现某类文件不生效,用 Ctrl+Alt+Shift+P(Windows/Linux)把光标停在注释上,看状态栏显示的实际 scope —— 若是 comment.block.c 这类,就得把配置里的 scope 改成更具体的值,或加多条规则分别匹配。
TodoReview 扫描和 Highlight 渲染要分开理解
TodoReview 只负责扫描并生成跳转列表,它默认不画颜色;即使你配了 keywords,颜色是否显示完全取决于当前主题有没有定义 keyword.other.todo 这个 scope 的样式。多数轻量主题没定义,所以你看到的还是灰色文字。与其折腾主题兼容性,不如直接用 Highlight 插件覆盖渲染逻辑——它不依赖主题,不依赖语法文件改动,改完配置立刻生效,且作用域绑定清晰。
真正难的不是写正则,而是确认目标文本落在哪个 scope 层级里;哪怕正则再准,scope 错一层,就全白配。

















