guttercolor左侧无色块通常因sublime未将文件识别为支持颜色语法的类型，需手动设置正确语法（如css、source.js等），且仅识别静态颜色字面量，不支持现代css颜色函数及变量引用。
为什么GutterColor装了但左侧没色块？
90% 的情况是 Sublime 没把当前文件识别为支持颜色语法的类型。GutterColor 不靠正则扫字符串，而是依赖编辑器的 source.css、source.scss、source.js 等作用域触发。右下角状态栏显示 Plain text 或 HTML 时，哪怕你写的是 color: #ff6b6b，插件也完全不响应。
- CSS 文件：点击右下角语法标识 → Set Syntax → CSS（不是 HTML 或 Plain Text）
- .vue 文件中
<style></style>块：必须设为source.css.postcss或source.css.scss，source.vue不行 - JS 文件里写
el.style.color = "#3498db"：需确认语法是source.js，且颜色在字符串内——GutterColor 默认支持，但${bg}这类变量引用仍不识别
GutterColor支持哪些颜色格式？默认不支持什么？
它只认明确、静态、无计算的颜色字面量。能识别的包括：#fff、#ffffff、rgb(255, 99, 71)、rgba(0, 255, 0, 0.5)、hsl(120, 100%, 50%)、red、transparent。不能识别的有：
-
oklch(50% 0.2 250)、color(display-p3 1 0 0)、hwb(200 10% 20%)—— 这些属于现代 CSS 颜色语法，GutterColor 完全不解析 -
var(--primary)、color-mix(in srgb, red, blue)、lab(50% 20 10)—— 非字面量，无法静态推导 -
#RGBA（如#f00a）—— GutterColor 当前版本不支持带 alpha 的简写十六进制
怎么调大左侧色块或改样式？
GutterColor 自身不提供图形化设置面板，所有外观控制都靠手动改 JSON 配置。打开 Preferences → Package Settings → GutterColor → Settings - User，填入以下常用项：
-
"gutter_size": 16—— 色块直径，默认 12，建议设 14–16 更易看清 -
"gutter_alignment": "left"—— 可选"left"或"right"，决定色块贴左还是贴右 -
"gutter_icon": "circle"—— 图标形状，"circle"（默认）、"square"、"dot" -
"gutter_opacity": 0.9—— 透明度，0.0～1.0，低于 0.7 在深色主题下可能看不清
注意：配置文件必须是合法 JSON，缺逗号、多引号、括号不匹配都会导致整个插件失效。
和 ColorHelper、ColorHighlighter 的关键区别在哪？
别混用——它们解决的问题根本不同：
-
GutterColor：只在 gutter 区画小色块，不悬停、不调色、不支持现代语法，胜在轻量、启动快、几乎零配置 -
ColorHelper：支持oklch()、color(display-p3)等全部现代语法，但依赖光标位置 + 作用域 + 开关三者同时满足，不显示色块，只悬停预览 -
ColorHighlighter：在代码行内加背景色块，支持更多格式（可配"supported_color_types"），但默认不处理字符串，且开启"color_highlight_in_strings"后容易误触、拖慢响应
真正需要精准调试 oklch(75% 0.22 280) 或验证 display-p3 色域时，GutterColor 就只是个辅助标记，不能替代 ColorHelper 的作用域级识别逻辑。
