必须勾选“Fetch external documentation”才能使鼠标悬停显示含MDN链接的富文本弹窗;编辑器字体与悬停框字体需分别在Editor→Font和Appearance→UI Options中独立设置,且高分屏下需添加-Dsun.java2d.uiScale=1.0参数修复模糊。

在 IDEA 2026 中,鼠标悬停查看 API 文档和调整编辑器字体大小是两个高频刚需操作——前者决定你能否快速理解第三方库行为,后者直接影响长时间编码的视觉疲劳程度。这两个功能看似独立,但实际共用一套底层渲染逻辑,调错一处可能让悬停提示文字模糊难辨。
启用并验证鼠标悬停文档显示
打开任意 Java 文件,在某个类名(如 ArrayList)上静置鼠标 0.3 秒以上。
若未弹出文档框,请按 Ctrl+Alt+S 进入设置 → Editor → General → Code Completion,确保勾选 “Show the documentation popup”。
关键验证点:【必须勾选“Fetch external documentation”】,否则悬停只显示本地 Javadoc,无法链接到 MDN 或 Spring 官方文档。
重启 IDE 后再次悬停,出现带超链接的富文本弹窗即成功。
全局调整编辑器字体大小(含悬停弹窗)
按 Ctrl+Alt+S → Editor → Font,修改 Size 值(建议从 14 起试)。
注意:此设置仅影响编辑区代码字体,【悬停弹窗、结构提示、工具窗口标题等所有 UI 字体需单独设置】。
返回设置首页,搜索 Appearance → 进入 Appearance & Behavior → Appearance → UI Options → Override default fonts by,勾选并设为相同字号。
这一步漏掉会导致悬停框文字小得看不清,而代码却很大——视觉割裂感极强。
用快捷键动态缩放(临时应急)
方法一:按住 Ctrl + 鼠标滚轮向上/向下,实时缩放当前编辑器内容(含行号、折叠标记),松开即生效。
方法二:按 Ctrl+Shift+A → 输入 Change font size → 选择 “Increase font size” 或 “Decrease font size”。
⚠️ 注意:此方式仅作用于当前编辑器标签页,关闭文件后重开会恢复默认值,不保存到设置。
修复悬停框文字模糊或错位
第一步:确认系统 DPI 缩放是否开启。Windows 设置 → 显示 → 缩放与布局 → 若非 100%,IDEA 可能渲染异常。
第二步:在 IDEA 启动目录下找到 bin 文件夹,编辑 idea64.exe.vmoptions(Windows)或 idea.vmoptions(macOS/Linux),末尾添加:
-Dsun.java2d.uiScale=1.0
第三步:重启 IDEA。该参数强制禁用 Java 的自动 DPI 缩放,解决高分屏下悬停框文字发虚、图标错位问题。


















