ColorHighlighter 插件名易错为 ColorHighlight_sublime,实为少“r”即无法安装;需确认语法支持、避免插件冲突、按需配置 color_formats。

ColorHighlighter 插件名不是 ColorHighlight_sublime
很多人搜 ColorHighlight_sublime,但实际插件在 Package Control 里叫 ColorHighlighter——少一个 r 就装不上。它不维护旧名,也不重定向,输错就直接搜不到。
常见错误现象:Package Control: Install Package 里输 ColorHighlight 或 ColorHighlight_sublime,列表空着;或者装了同名但功能完全不同的废弃插件(比如只支持 Sublime Text 2 的老版本)。
- 认准官方 GitHub 名:https://github.com/Monnoroch/ColorHighlighter
- Sublime Text 4 推荐用
Package Control安装,别手动下载 zip 解压 - 安装后默认启用,不用额外配置就能高亮
#ff0000、rgb(255,0,0)、hsl(0,100%,50%)、var(--primary)这类颜色值
颜色没高亮?检查语法定义和作用域
插件依赖当前文件的语法(syntax)来识别颜色写法。如果打开的是 .txt 文件,或语法被误设为 Plain Text,ColorHighlighter 就不会触发——它不全局扫描,只在支持的 scope 里工作。
使用场景:你在 .vue 单文件组件里写 style 块,但高亮失效;或在 .js 里写了 el.style.backgroundColor = '#00ff00' 却没反应。
- 确认右下角显示的语法名是
CSS、SCSS、Less、Vue Component、JavaScript等受支持的类型(插件 README 有完整列表) - 手动切换语法:菜单栏
View → Syntax → CSS(或对应语言),看是否立刻生效 - 某些自定义语法(如 Tailwind CSS 插件改写的
HTML)可能覆盖了颜色 token 的 scope,导致插件“看不见”颜色文本
自定义颜色格式需要改 color_formats 配置
默认只识别标准 CSS 颜色写法。如果你大量用 rgba(0,0,0,0.2)、hwb(240 0% 0%)、甚至自定义变量如 $blue-500,就得手动加规则。
参数差异:插件通过正则匹配颜色文本,color_formats 是一个数组,每项是形如 {"name": "my-hex", "regex": "^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$"} 的对象。
- 配置路径:
Preferences → Package Settings → ColorHighlighter → Settings - 不要直接改 Default 设置,把需要的格式 copy 到 User 设置里再改
- 正则必须用双引号包裹,且不能有 JS 风格的修饰符(如
/i),Sublime 的 regex 引擎不支持 - 加太多复杂正则会影响编辑器响应速度,尤其在大文件中滚动时
和其它颜色插件冲突(比如 BracketHighlighter 或 Emmet)
多个插件同时修改同一行的 view layer,容易出现高亮闪烁、颜色块错位、甚至 Sublime 卡死。最典型的是 BracketHighlighter 开启了 bracket_styles 中的 color 类型,和 ColorHighlighter 渲染层打架。
性能影响:冲突不报错,但你会感觉光标移动变慢,或某段颜色突然不显示,切个标签页再切回来又好了——这是渲染层被反复覆盖的表现。
- 临时禁用其它插件测试:用
Package Control: Disable Package逐个关掉疑似插件 - ColorHighlighter 的
enable_on_post_save_only设为true可降低实时渲染压力(但失去即时预览) - Emmet 的
css_colors选项(在 Emmet 设置里)和 ColorHighlighter 功能重叠,建议关掉其中一个
真正麻烦的不是装不上,而是它悄悄失效——比如换了个语法、开了个新插件、或者团队共享的 Sublime 配置里删掉了 color_formats 条目。遇到不显示,先看右下角语法名,再看 Package Control 里插件是否真启用,最后才动配置。