Sublime Text 4 默认不支持颜色预览，必须装插件；但别装错——ColorHighlighter 和 Color Highlight 是两个不同插件，功能、配置、生效逻辑都不同，混用或装错名字是预览失败的最常见原因。
怎么装对插件：名称、渠道、重启缺一不可
装错名字 = 白忙活。Package Control 里搜 ColorHighlighter（结尾带 r，无空格、无下划线、无连字符），不是 Color Highlight、ColorHighlight 或 ColorPicker。
按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS），输入 Install Package等列表加载完，输入 ColorHighlighter，点安装安装后必须重启 Sublime Text —— 很多人跳过这步，结果以为插件失效手动解压 zip 到 Packages/ 目录？别做。ST4 的插件沙箱会拒绝未签名的 Python 包，只认 Package Control 安装的版本
为什么装完没反应：语法识别比配置还关键
插件不会主动扫描所有文本，它只在 Sublime 认为“可能是颜色上下文”的文件里启动。右下角状态栏显示的语法模式决定一切。
若显示 Plain Text、JSON 或 Python，插件完全不运行 —— 点它，手动设为 CSS、SCSS、HTML 或 JavaScript在 .vue 或 .svelte 文件里写内联 style，需把光标停在 style 标签内，再右键 → Set Syntax → CSS，否则不识别JS 文件中写 el.style.color = "#ff0000"，默认也不触发 —— 因为插件默认不进字符串，得靠配置打开
JS/TS 字符串里颜色不亮？开开关 + 强制刷新
开启 color_highlight_in_strings 后，插件会扫描所有字符串内容，这是性能敏感操作，不能靠默认值。
打开 Preferences → Package Settings → ColorHighlighter → Settings – User添加一行：{"color_highlight_in_strings": true}（注意 JSON 格式，双引号、逗号、花括号一个都不能少）保存后，按 Ctrl+Shift+P 输入 Color Highlighter: Highlight 手动执行一次，强制刷新缓存（不用重启）如果项目里有大量非样式字符串（比如日志模板、URL 拼接），可加 "supported_color_names": false 关掉预定义色名匹配，微调响应速度
色块看不见 / 位置歪 / 太淡？别改主题，先查三个参数
预览效果不取决于 Sublime 主题，而由 ColorHighlighter 自身设置控制。很多“渲染异常”其实是 ha_style 和 preview_offset 没对上当前字体或 DPI。
"ha_style": "filled"（推荐）—— 填充色块；若设成 outlined，在某些主题下边框可能极细甚至隐形"preview_size": 20 —— 默认 16，在高 DPI 屏幕或等宽字体下容易看不清，建议调到 20 或 24"preview_offset": 2 —— 若色块盖住文字或偏左，试设为 2 或 -2 微调水平位置别碰 .sublime-color-scheme 文件里的 lineHighlight —— 这个 key 决定的是行高亮背景，和颜色预览无关
真正难调的不是怎么开，而是什么时候不开：比如在大型 TSX 项目里全局开启 color_highlight_in_strings，又没关掉 supported_color_names，就可能让小文件输入延迟从毫秒级变成明显卡顿。这种细节，文档不会写，但你改完设置后多敲几行代码就能感觉到。
评论(0)