Highlight插件离线生效需两步:先正确安装Package Control和Highlight.sublime-package到Installed Packages目录,再配置正则规则与主题scope颜色;缺一不可。

Sublime Text 本身不支持 TODO/FIXME 高亮,必须装插件;但 Package Control 在离线环境下不可用,Highlight 插件无法通过命令面板安装——得手动放文件、配正则、改主题 scope 才能生效。
为什么搜不到 Highlight 插件?Package Control 根本没运行
离线机器上 Ctrl+Shift+P 输入 Install Package 没反应,不是插件下架了,是 Package Control 压根没加载。控制台执行 import package_control 报 ModuleNotFoundError 就坐实这点。
- 先确认 Sublime 版本:
sublime.version()返回4xxx才适用 ST4 安装脚本 - 关闭 Sublime,删掉
Installed Packages/下所有含Package Control的文件 - 从 https://packagecontrol.io/Package%20Control.sublime-package 下载完整版(180–220 KB),拖进
Installed Packages/目录,不改名、不解压 - 重启后在命令面板搜
Package Control: List Packages,能列出一堆插件才算真正就绪
离线装 Highlight 插件:只放 .sublime-package 文件到 Installed Packages/
Highlight 插件没有 GitHub 源码 ZIP 包,只有 .sublime-package 发布包;它不提供语法定义,只靠用户配置正则规则驱动高亮,所以不能解压扔进 Packages/ 目录——那是给 Vue Syntax Highlight 这类语法插件用的路径。
- 去 https://github.com/SublimeText/Highlight/releases 找最新
Highlight.sublime-package(如v2.12.0.sublime-package) - 下载后直接拖入
Installed Packages/目录(不是Packages/) - 重启 Sublime,检查
Preferences → Package Settings → Highlight → Settings – User是否可打开 - 若菜单不存在,说明文件放错位置或名字带版本号(必须是
Highlight.sublime-package,不能叫Highlight-v2.12.0.sublime-package)
配正则 + 改主题:TODO 高亮才真出现
装完只是第一步。Highlight 默认不启用任何规则,且高亮颜色依赖主题里 comment 或自定义 scope 的定义——很多暗色主题根本没写 todo_highlight 对应的颜色,结果就是“规则写了,但看不见”。
- 打开
Preferences → Package Settings → Highlight → Settings – User,粘贴以下最小配置:
{
"highlights": [
{
"name": "todo_highlight",
"scope": "comment",
"regex": "\b(TODO|FIXME)\b",
"style": "underline"
}
]
}
-
scope设为comment是关键:只在注释里高亮,避免误标变量名;若想在字符串里也标,得加"ignore_scope_list": [] - 打开当前主题的
.sublime-color-scheme(用Ctrl+Shift+P → Show Scope Name确认路径),在"rules"数组里加一行:
{"name":"TODO highlight","scope":"todo_highlight","foreground":"#FF8C00"}
- 别用太淡的颜色,深色主题下
#999基本不可见;foreground比background更可靠,避免和 selection 背景冲突
替代方案:不用插件也能临时高亮
如果连 .sublime-package 文件都搞不到,或者主题改不动,Find All 是最轻量的兜底方式——它不依赖插件,纯靠 Sublime 内置功能。
- 按
Ctrl+F打开查找框,输入(TODO|FIXME) - 点右上角
.*图标启用正则模式 - 点
Find All,所有匹配项立刻高亮(黄色背景,可滚动跳转) - 配合
Find in Files(Ctrl+Shift+F)还能跨文件搜索,结果页双击直达 - 这个高亮不持久、不自动刷新,但胜在零配置、离线即用
离线环境里,Highlight 插件能否生效,80% 取决于 .sublime-package 文件是否放对目录、剩下 20% 在于主题是否定义了对应 scope 颜色——这两步漏掉任意一个,都会让你以为“插件坏了”,其实只是没被看见。

















