Pigments不会自动高亮颜色，仅在语法作用域、文件类型、配置项三重匹配时生效；#ff0000在CSS中无反应是因文件未被识别为source.css等支持作用域，需检查右下角语法标识并手动配置Supported Grammars，v0.40.2为最后兼容版本，1.59+不可用。
Pigments 不会自动高亮颜色，装上就用是错觉；它只在满足语法作用域、文件类型、配置项三重匹配时才渲染色块。
为什么 #ff0000 写在 CSS 里没反应？
常见错误现象：background: #ff0000; 没出现小色块，但 HTML 的 <style></style> 块里却正常 → 这说明当前文件没被 Atom 识别为支持颜色的语法作用域。
- 检查右下角状态栏：是否显示
source.css或source.scss？若显示text.html.basic却不在<style>标签内，则不会触发 - Pigments 默认只启用在
.css、.scss、.less、.sass文件，以及.html中的<style>块（内联属性不支持） - 只识别标准写法：
#abc、#aabbcc、rgb(255,0,0)、red；不识别var(--primary)、"#" + color、color-mod()
如何让 Pigments 支持 Vue 或 JS 字符串里的颜色？
必须手动扩展 Supported Grammars 配置，否则它根本不会扫描那些区域。
- 打开
Settings → Packages → pigments → Settings - 在
Supported Grammars输入框中添加对应语法作用域，例如：source.css.vue（Vue 单文件组件的 style 块）、source.js（JS 文件）、text.html.basic（HTML 全局，含<style>） - 若开启
source.js，建议同步填入Ignore Scopes，如string.quoted.other（跳过注释里的假颜色），否则大 JS 文件会轻微卡顿 - 修改后需重启 Atom 或执行
Window: Reload，配置才生效
安装失败或启用后完全无响应？
官方 apm install pigments 在 Atom 1.58+ 已失效——GitHub 上的 Pigments 最新版已停止维护，且与新版 Atom 不兼容。
- 唯一可行路径：手动安装最后兼容版本
v0.40.2 - 步骤：下载 ZIP 解压 → 终端执行
apm link --dev /path/to/pigments-0.40.2→ 重启 Atom - 确认启用状态：
Settings → Packages → 搜索 pigments → 点击 Enable 按钮（若为灰色则未启用） - 注意：Atom 1.59+ 用户基本无法使用 Pigments，这不是配置问题，是兼容性硬限制
颜色预览卡顿或变慢？
Pigments 默认递归扫描整个项目目录找颜色值，大项目（尤其含 node_modules）会导致 Atom 卡顿、内存飙升、色块延迟几秒才出现。
- 关闭
scanWholeProject，只扫描当前打开的文件 - 把
ignoredNames加上node_modules、dist、build - 降低
colorRegexps精度：删掉不常用的匹配规则（比如去掉对hsl(...)的支持） - 禁用
showPalette（右下角颜色面板），它是主要性能拖累源
最常被忽略的一点：Pigments 和 highlight-selected 同时启用时，光标所在颜色值可能被遮盖或闪烁——这不是 bug，是 Atom 渲染层对高频 DOM 更新的调度限制；优先保留 Pigments，关掉 highlight-selected 的 Highlight on Right Click 选项更稳妥。
