quick documentation配色需在editor→color scheme→documentation中设置，包括background、foreground、link及自定义字体；改完需关闭并重触悬浮窗生效。
快速文档悬浮窗（Quick Documentation）的配色不归 Editor → Color Scheme 管理
很多人在 Editor → Color Scheme → General 里翻遍 Text、Popups、Hints 等节点，却找不到 Quick Documentation 的颜色控制项——因为它被单独归类在 Documentation 下，且默认继承自当前配色方案的「基础弹窗样式」，但实际渲染逻辑更独立。
关键点：它不响应 Popup background 或 Tooltip background，必须手动定位到 Documentation 子项。
修改路径和必调参数
打开 Settings → Editor → Color Scheme → Documentation，这里有两个核心项：
-
Documentation background：控制悬浮窗整体背景色，推荐设为#252525（比代码区稍深，避免视觉粘连） -
Documentation foreground：控制文字主色，建议与Default text → Foreground一致（如#A9B7C6），否则代码块内文字会突兀变色
⚠️ 容易踩的坑：
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 改完不生效？检查是否误启了
Transparent（某些第三方主题默认勾选，会导致背景透明化） - 链接文字（如函数跳转、类型定义）颜色由
Documentation link单独控制，不随foreground变化，需一并调整 - 如果用了语义高亮（Semantic Highlighting），函数名/参数在文档中仍会按语言规则着色——这是正常行为，不是配色失效
字体大小和行距要同步调
Quick Documentation 的字体大小不走 Editor → Font，而是绑定在 Documentation 配色项里：
- 勾选
Use custom font才能调字号（默认未勾选） - Size 建议设为 13–14（比代码字体小 1 号，保持信息密度）
- Line spacing 推荐 1.3，否则多段代码示例容易挤在一起
注意：这个字体设置只影响悬浮窗，不影响编辑器内文档注释（/** */）的渲染——后者走的是 Language Defaults → Doc comment。
改完要重启已打开的悬浮窗才能预览
修改后，已存在的 Quick Documentation 浮层不会自动刷新。必须：
- 关闭当前悬浮窗（按
Esc或鼠标移出） - 重新触发（如把光标停在函数名上，再按
Ctrl+Q） - 如果用的是鼠标悬停自动触发，需移出再悬停一次
最隐蔽的问题是：某些插件（比如 Go Template 支持、gRPC 插件）会注入自己的文档片段，它们的颜色可能绕过 Documentation 设置，走的是各自语言的 Injected language fragment 配色——这种属于例外，不在通用调整范围内。
