guttercolor能在gutter中画小色块，但仅支持#ff5733、rgba()、hsl()、命名色等基础格式，不支持oklch()、display-p3、#rgba等现代语法，且无悬停预览、调色面板或alpha滑块功能。
GutterColor 能不能直接在 gutter 里画颜色块
能，但只画小色块，不提供悬停、调色、alpha 滑块等交互功能。它识别到 #FF5733、rgba(0, 255, 0, 0.5)、hsl(120, 100%, 50%)、rebeccapurple 这类基础格式时，会在左侧 gutter 区域（行号旁）渲染一个微缩色点。
它完全不支持：oklch(65% 0.21 250)、color(display-p3 0.9 0.2 0.3)、#RGBA（带 alpha 的简写）、hwb(120 20% 30%) 等现代语法——不是配置问题，是插件本身没实现解析逻辑。
常见错误现象：
- 装完没反应：90% 是文件语法没设对，右下角显示
Plain text或HTML（非CSS/SCSS/source.css.postcss） - JS 里
el.style.color = "#336699"不出块：GutterColor 默认跳过字符串上下文，不提供color_highlight_in_strings这类开关 - 色块糊成一片或看不清：gutter 背景色太暗/太亮，和插件绘制的圆点冲突（需手动调配色方案）
GutterColor 安装后为什么 gutter 里没色块
安装本身极轻量，但触发依赖三个硬条件同时满足：
- 必须通过
Package Control: Install Package安装GutterColor（名称严格匹配，无空格、无复数） - 当前文件语法作用域必须含
source.css、source.scss、source.css.postcss或source.js；.vue文件中<style></style>块需手动右键 →Set Syntax → source.css.postcss - 光标必须停在合法颜色字面量内部，比如停在
#3b82f6的任意字符上；停在var(--primary)或color-mix(...)上不会触发
验证方式：光标停在颜色值上，按 Ctrl+Shift+P → 输入 Developer: Show Scope Name，输出中必须含 constant.other.color 或 support.constant.color 类 scope，否则 GutterColor 根本收不到信号。
GutterColor 需不需要 ImageMagick 或 convert 工具
不需要。这是老资料误导——2017 年旧版 GutterColor 曾依赖 convert 渲染渐变或复杂色，但当前（2026 年）所有稳定版本已完全移除该依赖，纯靠 Sublime 的 API 绘制纯色圆点。
如果你在配置里看到 "convert_path": "/usr/local/bin/convert" 这类字段，删掉即可；保留它反而可能引发路径错误或启动延迟。
唯一需要外部工具的场景是：你想用 GutterColor + 自定义命令生成 PNG 色卡并插入文档——那属于高级定制，和基础预览无关。
怎么让 gutter 色块看得清又不抢戏
GutterColor 绘制的色块尺寸固定（约 8×8px），视觉是否清晰，全取决于你配色方案中 gutter 的背景与前景设置。
关键操作步骤：
- 进
Preferences → Browse Packages…→ 打开Packages/User/，复制当前配色方案（如Monokai.sublime-color-scheme）到此处并重命名 - 在副本中添加或修改
gutter规则，例如：{ "name": "Gutter", "scope": "gutter", "background": "#2a2e37", "foreground": "#9da5b3" } - 保存后，从菜单
Preferences → Color Scheme重新选一次该方案生效
避坑提示：别用 #000000 或 #FFFFFF 作 gutter.background；深蓝灰系（如 #2a2e37）既能衬出浅色块，又不会吞掉 Git 修改标记（►）和断点（●）。
