六三门每天打开 IDEA 写代码，一坐就是大半天，眼睛从干涩到发酸再到刺痛，几乎成了程序员的职业病。我也试过把背景调成豆沙绿、戴防蓝光眼镜、开夜间模式，但效果都一般。直到我换上了 Catppuccin Theme 这个护眼主题，眼睛的负担才真正降了下来。如果你也是 IntelliJ IDEA 的用户，长期被默认的 Darcula 纯黑背景刺得难受，又不想用那种"伪护眼"的绿色壁纸，这篇文章应该能帮到你。
Catppuccin 是一个开源的配色方案社区项目，注意它不是一个单一的插件，而是一整套跨工具的色彩体系。在 JetBrains 系 IDE（IDEA、PyCharm、GoLand、WebStorm 等）中，你可以直接安装官方的 Catppuccin Theme 插件，一键把编辑器切换成它的专有配色。这个主题最大的特点是：不追求高对比、不追求"炫酷科技感"，而是用低饱和度的暖色调、柔和的对比度，让长时间盯代码时眼睛不那么容易疲劳。这篇文章我会从护眼原理、四种配色口味的选择、安装配置、进阶调优到踩坑记录，完整走一遍，适合所有用 IDEA 且在意眼睛舒适度的开发者参考。
1. 为什么折腾一圈护眼方案，最后留在了 Catppuccin
先说个可能反直觉的结论：护眼不等于绿色，也不等于越暗越好。 我最早跟很多人一样，把编辑器背景改成豆沙绿（就是经典的 #CCE8CF 那种），以为绿色能缓解疲劳。实际用下来，绿底配上代码原有的彩色高亮，画面非常脏，对比度反而变得很奇怪，看不了半小时眼睛更累了。后来我又试过把 IDEA 的 Darcula 主题强行调低亮度，结果代码文字和背景糊成一片，费眼程度不减反增。
真正科学的护眼逻辑，不是"什么颜色护眼"，而是降低亮度波动和蓝光刺激，同时保证文字可读性。人眼在长时间工作时，最怕的是两种东西：一是高强度的蓝光（波长短、能量高，容易引起视疲劳），二是画面中明暗对比过于剧烈，导致瞳孔频繁缩放。纯黑背景配纯白文字就是典型的反面教材——晚上看还好，白天办公室光线充足的时候，黑底白字的眩光感很强，眼睛要不断适应屏幕和周围环境的亮度差。
Catppuccin 的设计思路恰好踩在这两个点上。它的暗色系（Mocha / Macchiato / Frappe）不是纯黑，而是带有灰蓝色调的深色背景，降低了整体亮度但保留了色彩层次。它用于代码高亮的颜色全部经过低饱和处理，比如红不是正红，是带一点粉调的柔和红；绿不是荧光绿，是偏青的柔和绿。整个色板看起来像是一杯牛奶咖啡（Catppuccin 直译就是"卡布奇诺"），暖而不刺眼，长盯不累。
我用 Catppuccin 半年多的体感是：连续写代码三四个小时，眼睛的干涩感比之前用 Darcula 轻很多，切到浏览器看白底网页时，也没有以前那种"突然被闪到"的感觉。这就是背景亮度与色温接近自然光环境带来的实际好处。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 四种口味怎么选：Latte、Frappe、Macchiato 与 Mocha 的实战对比
Catppuccin 最贴心的一点，是同一套配色提供了四个"口味"（Flavor），覆盖从亮色到深色的四个档位。很多人第一次装完插件，看到主题列表里四个选项直接懵了，不知道该选哪个。我先给个一句话结论：
- 白天用得少、喜欢浅色界面、室内光线充足的人，选 Latte；
- 绝大多数人，直接在 Macchiato 和 Mocha 之间选一个；
- 想要暖意最强、夜里用着最舒服的，选 Mocha；
- 觉得 Mocha 的深色背景有点压抑，但又不想要太亮的，选 Frappe。
2.1 色值对比与适用场景
下面这张表是我从官方色板里整理出来的核心参数对比，方便你直观感受四个口味的不同：
| 口味 | 背景色 | 前景/文字色 | 风格描述 | 适合场景 |
|---|---|---|---|---|
| Latte | #EFF1F5（暖白） | #4C4F69（深灰蓝） | 低对比亮色，纸张质感 | 白天阳光充足的房间、办公场景 |
| Frappe | #303446（灰蓝深色） | #C6D0F5（柔白） | 柔和暗色，对比度中等 | 上午下午的日常编码、不想太黑的环境 |
| Macchiato | #24273A（深蓝灰） | #CAD3F5（柔白） | 偏冷的暗色，层次分明 | 全天通用，暗色入门的稳妥选择 |
| Mocha | #1E1E2E（近黑带蓝调） | #CDD6F4（暖白） | 最高对比度的暗色，带咖啡暖调 | 夜间、弱光环境、个人最推荐 |
注意一个细节：Mocha 虽然是最深的那个，但它的背景并不是 #000000 纯黑，而是带着一点点灰蓝调的深色，这样能有效避免纯黑在 OLED 屏幕上产生的拖影感和眩光。它的文字色是 #CDD6F4，也不是纯白，而是稍微偏暖的白，刚好和背景形成中低对比度，长时间看不会刺眼。
2.2 我的选择和理由
我自己是 MacBook Pro 用户，屏幕本身亮度高、对比度强，白天在办公室用 Macchiato，晚上在家关灯后用 Mocha。两套配色之间切换只需要在设置里下拉一下，几乎是无缝的。如果你只能选一个，我建议直接上 Mocha，它是 Catppuccin 社区人气最高、调校最用心的一个口味，也是你在各种截图、博客里最常看到的那套配色。
提示：亮色口味 Latte 也值得一试。它不是那种刺眼的纯白背景，而是类似纸张的暖白，配深灰蓝文字，写代码的时候有种在看纸质文档的感觉。如果你白天用 IDE 的时间长，试试 Latte 反而可能比暗色更舒服。
3. 安装与基础配置：从插件市场到第一行高亮
Catppuccin 的安装比大部分 IDEA 插件还简单，不需要手动下载 jar 包，直接在插件市场里搜就行。不过有几个细节我要提前说一下，省得你装完一脸懵。
3.1 插件市场安装步骤
打开 IDEA，进入 File > Settings > Plugins（macOS 上是 IntelliJ IDEA > Settings > Plugins），切换到 Marketplace 标签页，搜索框输入 Catppuccin Theme，回车后你会看到两个结果：
- 一个是官方的
Catppuccin Theme，插件描述里带着 Catppuccin 社区专用的咖啡杯 Logo，发布者是Catppuccin Org； - 另一个可能是第三方仿制或改名插件，发布者不是官方组织，功能不全。
认准官方这个再点 Install。安装完成后 IDEA 会提示你重启，重启后进入 Settings > Appearance & Behavior > Appearance，在 Theme 下拉框里就能看到 Catppuccin Latte、Catppuccin Frappe、Catppuccin Macchiato、Catppuccin Mocha 四个选项。选完点 Apply，整个 IDE 的界面（包括侧边栏、顶部菜单、状态栏、设置面板）会整体换成对应配色，不只是编辑器区域变颜色。
3.2 新版本 IDEA 用户的注意点
如果你是 IDEA 2023.1 之后的新 UI 版本，Catppuccin 主题会同时作用于新 UI 和旧 UI。我个人感觉新 UI 搭配 Catppuccin 的效果更好——新版界面的圆角、间距设计跟 Catppuccin 的柔和调性很搭，看起来比 Darcula 那种硬朗的深色和谐得多。新 UI 下主题切换入口位置不变，还是 Settings > Appearance & Behavior > Appearance > Theme。
另外，如果你装了其它 UI 增强插件（比如 Material Theme UI），一定要把它的主题配色功能关掉，只保留它的一些辅助功能（比如文件图标、标签页样式），否则两个插件会互相覆盖主题，出来一个不伦不类的混搭色。这也是新手最容易踩的坑。
3.3 安装后可能出现的两个小问题
我装完第一周遇到过两个小问题，顺手记下来给各位避雷：
- 插件市场搜不到：大概率是 IDEA 版本太老（2020.1 以下），Catppuccin 官方插件要求 IDE 版本在 2020.1 以上。建议先升级 IDEA，或者去 JetBrains 插件官网下载对应版本的压缩包，在本地安装。
- 部分界面元素没变色：比如弹窗按钮、滚动条还是默认蓝。这种情况一般在重启一次 IDE 后就会消失，如果还在，检查是否有别的主题插件在后台干扰，把它卸载或禁用再试。
4. 进阶调优：背景渐变、自定义强调色与字体搭配
装好主题只是第一步，想让 Catppuccin 真正贴合你的使用习惯，还有几个进阶配置值得做。这些选项都藏在主题设置里，但很多人装完没注意，白白错过了 Catppuccin 最灵活的部分。
4.1 编辑器背景渐变：让大面积背景不再单调
Catppuccin 官方插件内置了一个非常出彩的功能：编辑器背景渐变（Editor Gradient）。开启后，编辑器背景会从你所选口味的基础背景色，渐变到另一个自定义颜色。这不仅仅是好看，视觉上还能缓解盯着一块纯色大屏的单调感。我个人的设置是：Mocha 底，渐变到深蓝紫色 #11111B（Catppuccin 的 Crust 色），看起来像深夜的星空边缘，很安静。
开启方式：Settings > Appearance & Behavior > Appearance > Catppuccin，勾选 Editor Gradient 开关，然后点后面的色块自定义渐变终点颜色。注意这个渐变不会影响代码文字，只作用于编辑器背景层，所以不用担心可读性问题。
4.2 自定义强调色（Accent Color）
Catppuccin 默认的强调色是薰衣草紫（Mauve，色值 #CBA6F7），用在光标、选中高亮、链接、按钮等元素上。如果你不喜欢紫色，插件允许你自定义一个强调色。路径同样在 Settings > Appearance & Behavior > Appearance > Catppuccin 面板里，找到 Accent Color，点开色盘自行选择。
我试过把强调色调成桃色 #FAB387，整体氛围会更暖一些，但后来还是换回了默认的 Mauve——因为 Catppuccin 的代码高亮色本身就是围绕 Mauve 搭配的，换掉强调色会导致编辑器里某些符号（比如关键字标注）和其它元素之间出现轻微的颜色冲突。说实话，Mauve 作为一个强调色，识别度足够高又不刺眼，我建议非必要不换。
4.3 与代码字体的搭配经验
主题定好了，字体要是随便用，效果会打对折。Catppuccin 的低对比配色特别吃字体的渲染质量——如果字体本身窄瘦、字形锐利，柔和配色也会显得有点轻飘。我试下来最稳的三款：
- JetBrains Mono：IDEA 自家的开源等宽字体，和 Catppuccin 是绝配。它字形舒展、字体渲染清晰，配合 Catppuccin 的中低对比度，阅读代码非常舒服。
- Fira Code：想要连字（Ligature）效果的话选它，就是把
=>、!=这类符号自动合并成更美观的复合字形。注意它需要开启 IDEA 的Enable font ligatures选项。 - Maple Mono：国内开发者维护的开源字体，圆润风，中文注释渲染效果不错，搭配暖色调主题很协调。
字体设置路径：Settings > Editor > Font，分别设置 Font 和 Size。我自己的标准是 JetBrains Mono 14 号，行距 1.4，看着不费劲。
4.4 光标与选中色的微调
Catppuccin 默认光标色是白色，在暗色背景下有点微弱。建议在 Settings > Editor > Color Scheme > General > Text > Caret 里把光标颜色改成紫色系，我自己用的是 #F5E0DC（奶油白偏粉）或者 #CBA6F7（薰衣草紫），这样光标移动时能更轻松地定位。选中的高亮背景也建议改一下，默认的蓝色选中框配 Catppuccin 的暖色系有一点点违和，改成紫灰色半透明会比较统一。
5. 让编辑器的高亮回归本质：代码配色与语义化调整
很多人以为主题安装完就大功告成了，其实还有一个极其重要的环节被忽略了：IDEA 的代码高亮配色是独立于 UI 主题的。 这句话翻译成人话就是——UI 界面的颜色由 Catppuccin 插件控制，但编辑器里那些 public、class、String 是什么颜色，由另一套"Color Scheme"（配色方案）管理。如果你不主动切换，代码高亮可能还是 IDEA 默认的那套 Darcula 配色，跟 Catppuccin 的 UI 根本不搭。
5.1 切换代码配色方案
安装 Catppuccin 插件后，它会自动附带一套代码配色方案（通常叫 Catppuccin 或 Catppuccin Mocha）。你需要在 Settings > Editor > Color Scheme 下拉框里手动选中它，代码高亮才会跟着变。选完点 Apply，你会发现两个明显变化：
- 代码里的大面积高亮从默认的铁灰蓝变成了 Catppuccin 的柔和撞色，关键字是粉红色（#CBA6F7 附近），字符串是柔绿色（#A6E3A1 附近），函数名是浅蓝色；
- 注释变成了灰蓝色斜体，没了默认方案那种刺眼的绿色，整体视觉噪音小很多。
我经常给同事演示这个步骤，很多人的反应是：原来 Catppuccin 的完整效果要这样才有啊。是的，UI 主题和代码方案是两个维度，缺一不可。
5.2 语义高亮的重要性
有了 Catppuccin 基础配色后，强烈建议再打开 IDEA 的语义高亮（Semantic Highlighting）。这个功能在 Settings > Editor > Color Scheme > Language Defaults > Semantic Highlighting 里，开启后同一个类里的不同变量会分配不同的柔和颜色，而不是千篇一律的默认色。配合 Catppuccin 的低饱和度色板，变量之间的区分度更清晰，读代码时能更快定位到作用域和引用关系。
不过要提醒一句：语义高亮对性能有微弱影响，极大型项目（几十万行代码）开启后偶尔会出现输入卡顿。如果你的机器配置一般，建议只在中小型项目里开，或者保持默认关闭。
5.3 让括号匹配与选中范围更"显眼但不刺眼"
Catppuccin 的柔和配色有一个小副作用：当代码中括号嵌套很深时，默认的括号高亮不够明显。建议手动 Settings > Editor > Color Scheme > General > Code > Identifier under caret 之类的选项，把括号匹配高亮的背景色改成 Catppuccin 的 Surface 色（#313244）加一点边框色，这样既醒目又不刺眼。同理，选中代码后那个高亮选区的颜色也可以调成淡紫色半透明，避免满屏大蓝块晃眼。
6. 全生态统一：JetBrains 全家桶与终端、浏览器的 Catppuccin 化
Catppuccin 最大的隐藏价值，在于它不只是一个 IDEA 插件，而是一整套跨工具的配色体系。当你把常用工具都切成同一套配色后，视觉上的"割裂感"会大幅降低——以前从 IDEA 切到黑色终端、再切到白色浏览器，眼睛要重新适应一次亮度；现在全平台都是 Catppuccin 的色调，切换时几乎无感。
6.1 JetBrains 全家桶通用
你用的 PyCharm、GoLand、WebStorm、DataGrip 等，在各自插件市场里都能搜到 Catppuccin Theme，安装和配置方式跟 IDEA 完全一致。如果你日常多语言开发频繁切换 IDE，建议每个都装一遍，保持统一的视觉体验。我自己的习惯是全家桶全部用 Mocha 口味，这样无论打开哪个 IDE，熟悉感都在，不需要重新适应色彩。
6.2 终端(iTerm2 / Windows Terminal)的搭配
终端配色是很多人忽略的一块。我用的 macOS 终端是 iTerm2，直接在 iTerm2 的 Preferences > Profiles > Colors > Color Presets 下拉框里可以导入 Catppuccin 官方配色方案。Windows 上则可以在 Windows Terminal 的设置 JSON 里加入 Catppuccin 的 color scheme 配置，一个晚上的工夫就能折腾完，但视觉统一带来的舒适感是长期的。
6.3 浏览器新标签页与代码托管平台
如果你愿意再花一点时间，Chrome/Edge 可以装 Catppuccin 配套的新标签页扩展，GitHub 的代码阅读页也可以通过 Stylus 类插件导入 Catppuccin 样式。这样你在浏览器里查文档、看 GitHub 代码的时候，眼睛感受到的亮度和色温跟 IDEA 里基本一致，整个工作流的护眼体验就闭环了。这一步属于锦上添花，非必须，但做过之后你会有种"整个世界终于统一"的满足感。
7. 使用半年后的经验与避坑清单
最后这部分，我把自己用了大半年 Catppuccin 后踩过的坑、总结出的经验一次性列出来。多数都是文档里不会写的东西，但实际使用中非常要命。
7.1 坑一：与代码统计类插件的配色冲突
如果你装了类似 Rainbow Brackets（彩虹括号）或者 GitToolBox 这类会给代码加额外高亮的插件，它们的默认配色是基于 Darcula 或 Light 主题设计的，颜色饱和度高，跟 Catppuccin 放在一起会特别突兀。解决办法是进这些插件的设置里，手动把高亮颜色的透明度调低，或者改用它们的自定义色，选 Catppuccin 色板里的对应颜色。彩虹括号插件我实测可以用 Settings > Other Settings > Rainbow Brackets，把每一层括号颜色改成 Catppuccin 的蓝、紫、青三色循环，效果非常协调。
7.2 坑二：IDEA 版本升级后部分颜色失效
JetBrains 每年发布大版本时，偶尔会改动主题结构的字段名，导致第三方主题的部分颜色失效（通常会变成默认的蓝色或者报错）。遇到这种情况不用慌，把 Catppuccin Theme 插件更新到最新版，然后清理一遍 IDEA 缓存：File > Invalidate Caches，重启后基本能恢复。如果更新后仍有某个局部颜色不对，可以去 Catppuccin 的 GitHub Issues 页面反馈，社区维护者响应很快，通常几天内就会发补丁。
7.3 坑三：开启渐变背景后，长时间编辑偶发卡顿
Catppuccin 的 Editor Gradient 功能实测下来确实有一点性能开销，尤其在大文件、低内存机器上，滚动或输入时偶尔会出现掉帧感。如果遇到这种情况，优先把渐变功能关掉，保留单一背景色，然后看是否恢复正常。我用的是 32G 内存的 MacBook Pro，开渐变没有明显影响，但 8G 内存的老款机器上会感觉到差异。性能换颜值，按需取舍就好。
7.4 一个事半功倍的技巧：把注释变灰
Catppuccin 的注释颜色默认是灰蓝色，我建议再调低一点它的亮度，让注释在视觉上进一步"退后"，突出真正的代码。操作路径：Settings > Editor > Color Scheme > Language Defaults > Comments，把注释的 Foreground 改成比默认更暗的灰（比如 #6C7086），斜体保持开启。这样一来，代码层次的视觉层级会更清楚，扫一眼就能把有效代码和备注区分开。
写在最后的一个小建议
如果你以前没用过任何护眼主题，我建议不要直接在第一个工作日就切换到 Catppuccin 的 Mocha 口味。人的眼睛对色彩的适应需要几天时间，突然从高对比的亮色/纯黑切到低饱和的柔和色，头一两天可能会觉得"有点灰"、不够精神。我自己是挑了周末两天在家适应，写点非紧急的代码或看看开源项目，等眼睛接受新色温后再带着这套主题回到日常工作，过渡会自然很多。
Catppuccin 真正厉害的地方，不是某一个颜色有多惊艳，而是它把"让自己舒服"这个目标贯彻到了整个工具的每个角落。在 IDEA 里装好它，花半小时把代码配色、字体、终端都调成一套体系，之后每次打开 IDE 写代码，眼睛都会感谢你这个决定。希望这篇文章能帮你少走点弯路，早点用上真正适合自己的护眼方案。