打开 PyCharm 默认的白色背景，连续盯上几个小时，眼睛是真的受不了。我最早是直接去 Settings 里翻“Background”这个关键词，结果翻到的是主题切换，并不是编辑器代码区的背景色，折腾半天也没改成想要的效果。后来才发现，PyCharm 里“自定义背景颜色”这件事，新版和旧版的入口完全不一样，而且光知道入口还不够，连带着当前行、选中块、行号区域的颜色也要一起调，否则改了白改。
这篇文章就把我自己改背景色的完整过程写清楚，覆盖新版（2020.1 及以后）和旧版（2019.x 及更早）两套操作路径，最后附上我自己试过比较舒服的三套配色方案和具体的 HEX 色值。不管你是刚开始用 PyCharm 的新手，还是已经用了很久但一直没搞明白颜色方案怎么配的老用户，都可以直接照着抄。
1. 先分清三种“背景颜色”：编辑区、IDE 主题、语法高亮
很多人改背景色失败，不是因为操作不对，而是从一开始就搞混了 PyCharm 里三个完全不同的概念：编辑器代码区的背景色、整个 IDE 窗口的主题、以及代码里各个元素的语法高亮颜色。这三个东西在设置面板里是分开的，入口不一样，作用范围也不一样。
1.1 为什么你改了设置却感觉没生效
我在网上看过不少求助帖，说“我明明在 Appearance 里把背景改成绿色了，为什么代码区还是白的”。原因很简单——Appearance 里选的是 Theme，也就是整个开发工具的明暗主题（比如默认的 IntelliJ Light、深色的 Darcula、高对比度 High Contrast），它控制的是工具栏、侧边栏、菜单栏、标签页这些窗口组件的色调，并不直接决定编辑器里那一大片代码区域的底色。
真正的代码区背景色，挂在 Color Scheme（旧版叫 Colors & Fonts）里面。Color Scheme 管理的是编辑器中每一个视觉元素的颜色属性：文字颜色、背景颜色、光标颜色、选区颜色、行号颜色等等。所以你要做的是“自定义背景颜色”，核心动作不是换 Theme，而是改 Color Scheme 里 Default text 这一项的 Background 属性。
如果不先把这两个概念分开，后面无论点进哪个设置项都会觉得不对。我建议你按这个理解来记忆：
- Theme（主题）：决定 IDE 窗口长什么样，只能选预设的几个，不能随便填颜色。
- Color Scheme（配色方案）：决定编辑器代码区长什么样，背景、前景、光标、选区都可以逐项改。
- Syntax Highlighting（语法高亮）：在 Color Scheme 内部，用来标记关键字、字符串、注释、函数名等代码元素的颜色，不影响整体背景，但会影响背景色改完之后文字清不清晰。
1.2 版本分水岭：新版与旧版的入口区别
PyCharm 在 2020.1 版本做了一次设置面板的整理，把“Colors & Fonts”改名成了“Color Scheme”，目录结构也跟着变了。这个版本就是新旧两套路径的分水岭。
| 版本范围 | 完整路径 | 关键设置项名称 |
|---|---|---|
| PyCharm 2019.x 及更早 | Settings → Editor → Colors & Fonts | General → Text → Background |
| PyCharm 2020.1 及以后 | Settings → Editor → Color Scheme | General → Default text → Background |
简单说，旧版进 Colors & Fonts，新版进 Color Scheme，虽然不是同一个单词，但做的事情完全一样。热词里有人搜“pycharm 2021.1.3”“pycharm community edition 2024.1.4”，这些都是新版，直接按第二章操作即可。
2. 新版 PyCharm（2020.1 及以后）自定义背景色的完整步骤
新版的路径看起来多一步，但其实反而更清晰。以下所有内容以 2024 年发布的社区版为例，专业版操作完全一致。
2.1 找到真正的入口：Color Scheme
打开 PyCharm 后，按Ctrl + Alt + S（macOS 上是Cmd + ,）直接进 Settings，然后依次展开：Editor → Color Scheme → General。
这时候你看到的界面左边是一个树形菜单，里面列着 Default text、Caret row、Line number、Selection 等等，右边是当前选中项的具体属性。在左侧选中Default text，右侧面板里有一个Background色块，点击它就能弹出取色器，在里面输入或者选取你想要的颜色，点 OK 后再点 Apply，整个代码区的背景色就变了。
这一步是整个操作的核心。很多人找不到背景色设置，就是因为没有意识到它在Default text里面，而不是单独有一个叫“背景颜色”的入口。
2.2 顺手把这三处一起改了：当前行、选中块、行号区
只改 Default text 的 Background，实际使用中会出现几个很尴尬的情况：光标所在那一行还是原来的颜色，看起来像一块补丁；选中的文字区域反白效果跟新背景不搭；行号区域的底色跟代码区背景不一致，界面显得很割裂。
所以我在实际配置的时候，会把下面这三项在同一时间一起改掉：
General → Caret row：这一项控制光标所在行的背景色。建议选一个比主背景稍微亮一点或暗一点的颜色，形成微弱对比就可以，千万别用高饱和色，否则定位光标时反而刺眼。General → Selection：控制鼠标选中代码时的背景色。注意这是“选中状态”的颜色，不是选中之后弹出来的菜单颜色。改深色背景时，选区建议用偏蓝的灰色，保持高对比度同时不刺眼。General → Line number：控制行号区域。行号区域的背景如果不改，会跟代码区出现一条明显的色带。我的习惯是行号背景比代码区背景暗一个档位，行号文字用灰色系，既清楚又不抢戏。
这三项改完，编辑器区才真正有了“整体感”。如果你平时用代码折叠、类结构视图，那些区域的背景跟 Default text 联动，不用单独改。
2.3 用了背景图怎么办：Background Image 会盖住一切
这是个非常容易踩的坑。新版 PyCharm 支持把一张图片设置成编辑器背景，入口在 Settings → Appearance & Behavior → Appearance → Background Image。很多人在网上看到别人贴的“渐变色背景”“星空背景”截图，就在自己的 IDE 里启用了背景图，之后再来改背景色，发现怎么改都没反应。
原因很简单：背景图是覆盖在背景色之上的。只要 Background Image 处于开启状态，你设置的纯色背景就不会露出来。
如果你就是想要一个纯色背景，记得先去 Background Image 面板点一下 Clear And Close，把之前的图片背景清掉，再回到 Color Scheme 改色。反过来，如果你希望背景图和纯色背景同时存在，可以把背景图的透明度调低（比如 10%-20%），这样它就不会完全遮住背景色，代码阅读时干扰也比较小。
3. 旧版 PyCharm（2019.x 及更早）的自定义方法
旧版虽然界面老一点，但核心逻辑一模一样。你只要把“Color Scheme”这个单词换成“Colors & Fonts”就行。
3.1 旧版入口：Colors & Fonts
老版本用户按Ctrl + Alt + S进入 Settings 后，找到 Editor → Colors & Fonts。界面左侧同样是树形分类，找到 General，右边展开的列表里有一项Text，Text对应的属性里就有一个Background色块。点击色块弹出取色器，输入你想要的十六进制色值，确认后 Apply。
如果你打开的 PyCharm 特别老，比如 2018.x，那设置项的布局会再旧一点，但路径依然是 Settings → Editor → Colors & Fonts → General → Text，这个规律是固定的。
3.2 旧版如何同步修改当前行与选区
旧版的Current line（当前行）在 Colors & Fonts 的Editor分类下面，选Caret row之后，把 Background 改成你想要的辅助色；Selection在 General 下的Selection项里，和当前行类似，改 Background 就行。
有一点要提醒：旧版的 Colors & Fonts 页面上方通常有一个 Scheme 下拉框，里面列着预设方案。如果你想改的是内置方案，PyCharm 会提示你先复制一份，这时候在弹出的对话框里给新方案起个名字，比如“我的护眼配色”，保存后再改。这一步不是为了增加仪式感，而是为了以后随时能切回官方默认配色，避免改崩了找不到恢复入口。
4. 三套配色推荐：护眼、夜间、暖琥珀，附色值与适用场景
背景色这个东西，参数不能乱抄，因为每个人的显示设备、使用环境、用眼习惯都不一样。但下面这三套方案是我结合自己长期使用和周围同事的实际反馈总结出来的，覆盖面比较广，你可以直接试，再在这个基础上微调。
4.1 经典豆沙绿：适合长时间日间编码
这套是流传最广的“护眼绿”风格，很多人写博客、写文档都推荐过。主背景我常用的是#C7EDCC，如果你觉得它偏亮，可以换成#CCE8CF或者#D4EED7，色相一样，明度略有差异。
为什么推荐绿色系？人眼对绿色光谱敏感度相对较高，长时间看不容易疲劳，而且这个颜色背景下，黑色文字对比度足够，不需要额外调亮显示器。不过它有一个隐藏缺点：如果你用的语法高亮方案里包含绿色系的注释色，比如默认注释就是绿色，那么在豆沙绿背景下注释会变得很不清楚。
解决办法是我在实际使用中处理过的：配合豆沙绿背景时，把注释颜色改成棕色系或者灰棕色，比如#7F5F20或#8A704D，这样既保留注释与代码的区分度，又不至于让注释“隐身”。
4.2 深蓝灰夜间背景：不会刺眼，长时间盯屏幕也不累
暗色背景现在几乎成了“标配”，但纯黑的背景其实不建议用，因为黑色环境下屏幕的漏光、眩光会很明显，浅色字看起来反而更费劲。我比较推荐的是带一点蓝调的深灰：主背景#282C34，这是 One Dark 系列常用的底色；想要更暗一点可以用#1E1F22，这是新版 IntelliJ 默认深色方案的底色。
深色背景搭配的前景色要注意：代码主体文字建议用浅灰色#D4D4D4或#ABB2BF，不要用纯白，纯白在暗底下太刺眼。字符串可以用偏黄色的#98C379或偏青的#56B6C2，关键字用稍微带一点蓝的紫色，亮度和对比度都要跟背景拉开一个档位。
我实际测试下来，#282C34配#ABB2BF的前景，再加上#2C313A的当前行背景，整体视觉非常柔和，很适合从早写到晚的人。
4.3 暖黄 / 羊皮纸背景：不喜欢暗色又不想要冷白时的不错选择
白天办公室里，冷白背景在阳光下反光比较厉害，但暗色背景又可能显得太压抑。暖黄类背景可以兼顾两者。我最常用的是#FDF6E3（Solarized Light 的背景色），颜色接近羊皮纸，看起来自带一层柔光，眼睛不容易被强光源刺激。
暖黄背景对字体颜色的要求跟豆沙绿有点类似：避免使用偏黄的浅色文字，避免浅色注释。我为此专门把注释调成了暖棕色#8A704D，把普通代码保持深灰色#586E75，关键字保持深蓝#268BD2。这样整体看起来非常统一，而且代码结构依然清晰。
4.4 三套方案横向对比
| 方案 | 背景色 HEX | 适合场景 | 当前行建议 | 注意点 |
|---|---|---|---|---|
| 豆沙绿 | #C7EDCC | 白天、长时间日间编码 | #B8DFC4 | 注释别用绿色 |
| 深蓝灰 | #282C34 | 夜间、弱光环境、追求专注 | #2C313A | 前景用浅灰别用纯白 |
| 暖黄羊皮纸 | #FDF6E3 | 室内光线偏强、怕冷白刺眼 | #F0E8D0 | 避免浅黄色文字 |
这套表格里的色值是我验证过可以直接落地的，不是随便给的。你全部复制进背景色取色器就能用，不需要二次调整亮度和对比度。
4.5 为什么别人推荐的色值到你电脑上就变难看
很多人有疑问：同一个#C7EDCC，网上截图里看起来温润细腻，自己电脑上却有点发灰或者泛白。这跟色值本身无关，主要取决于你的显示器色彩空间、伽马曲线、屏幕亮度，以及 PyCharm 所在系统的色彩管理是否启用。
我建议你拿到色值后，先改上去，然后花五分钟肉眼观察：在不同亮度的环境光下、打开注释较多的文件、打开字符串超长的代码，分别看一眼。如果感觉偏亮，就在原色值基础上把 RGB 三个值整体往下调 10-20；如果偏暗，就整体往上调。这个微调动作不可省略，网上任何一份“最优配色”都不可能替你做这一步。
5. 改完背景色后最容易忽略的连带设置
改完背景色，很多人的第一反应是“完事了”，去敲代码后发现还是不对劲。我把实际使用中几次翻车的连带设置一次性列出来，省得你二次折腾。
5.1 对比度问题：背景色和前景色会互相影响
背景色从纯白改成深蓝灰后，默认的前景色还是深色系，这时候普通代码可能看不清；改成豆沙绿后，默认的关键字蓝色可能会发闷。这是改背景色最容易遇到的问题。
我的处理思路是：先改背景，锁定背景之后再改四个前景优先级最高的元素——Default text 的 Foreground 控制普通代码文本颜色；Keyword 控制关键字颜色；String 控制字符串颜色；Comment 控制注释颜色。改的时候盯一个目标：每个元素之间就算色相拉不开，亮度也要拉开。注释可以略微低对比，但代码主体和关键字必须保持高对比。
如果你用的是我自己用的深蓝灰方案，可以直接参考这组前景色：普通文本#ABB2BF、关键字#C678DD、字符串#98C379、注释#5C6370。这套取值在显示上很稳，跟主背景的亮度差足够。
5.2 把配色存档导出：换电脑、换版本不重调
我一开始没有做存档，结果从专业版换到社区版，整个配色全丢了，十分耽误事。后来发现新版 PyCharm 有完整的导入导出功能：File → Manage IDE Settings → Export Settings，勾选你需要的配置项导出为一个 zip 包，新电脑上再通过 Import Settings 一键导入。
如果只想单独导出配色，不走全量导出的流程，可以直接找到配置目录下的colors文件夹，里面以.icls结尾的文件就是你自己保存的 Color Scheme。这个目录的位置因系统和版本而异，一般在 PyCharm 的 config 目录下（比如~/.PyCharm2024.1/config/colors，在 macOS 上是~/Library/Application Support/JetBrains/PyCharm2024.1/colors），找到后拷贝一份就行。
这个文件可以直接发给同事，对方把文件放进自己的colors目录，重启 PyCharm 后就能在 Color Scheme 下拉框里看到同名方案。这个分享方式比截图传色值要精准得多，因为它连语法高亮的颜色都一起带过去了。
5.3 怎么恢复默认配色
改崩了或不想用自定义方案了，恢复的方式很直接：进入 Color Scheme（旧版是 Colors & Fonts），在方案下拉框中选中默认方案（新版一般是Default，旧版是Default或Darcula），确认后所有颜色立即还原，不需要卸载重装，也不用删配置文件。
如果你之前复制过一份方案，默认方案还在，不会因为你改过背景色而损坏，这也是我前面一直建议“先复制再改”的原因。记住：官方默认方案是只读保护的心智模型在 PyCharm 里不成立，它放你改，但最稳妥的方式仍然是先另存一份自己的方案。
我个人在这件事上的心得是：配色这东西一定要在现场调，不能只看截图效仿。截图有压缩、显示器有差异，照着抄只会越来越花。先复制方案、再改背景、再调前景、最后微调对比度，按这个顺序走下来，基本一小时内能弄出一套自己满意且长期能用的背景色。如果你愿意折腾，还可以把改完的方案存下来，装进 U盘或者云盘，到任何一台机器上都能用同一个观感，这个体验比什么操作技巧都实在。
