PyCharm中关闭鼠标悬停自动显示文档，需在Settings→Editor→General→Code Completion中取消勾选“Show the documentation popup”，并同步关闭Editor→General→Other中的“Show quick documentation on mouse move”；若想保留提示可调高Autopopup delay至500–800ms。

PyCharm 默认开启鼠标悬停自动显示文档（Quick Documentation），但这个功能在频繁移动光标时容易干扰编码节奏，尤其在写代码中途弹出遮挡视线。关闭它不等于失去文档能力——你仍可按 Ctrl+Q 手动调用，更可控。

怎么关掉鼠标悬停自动弹窗

直接禁用「悬停触发」即可，不用改快捷键或删插件：

• 打开 Settings（Windows/Linux：Ctrl+Alt+S；macOS：Cmd+, ）
• 导航到 Editor → General → Code Completion
• 取消勾选 Show the documentation popup 旁边的复选框
• 点击 Apply 或 OK

改完立刻生效，无需重启 IDE。注意：这个设置只影响「悬停」行为，Ctrl+Q 和 Ctrl+P 等快捷键完全不受影响。

为什么有时候关了还弹？检查这三项

常见误判是以为已关闭，实际被其他设置覆盖：

PyCharm 2026.2

PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包，下载地址指向官方 Windows 安装包直链，可用于旧项目兼容、版本回退和环境测试。

下载

• Editor → General → Other → Show quick documentation on mouse move 这个开关独立存在，必须也关掉（它比 Code Completion 里的选项优先级更高）
• 如果你启用了 Quick Definition（Ctrl+Shift+I），它默认也会在悬停时预加载，可在同页面关闭 Enable quick definition on hover
• 某些插件（如 Python Scientific Mode、Rainbow Brackets）会重写悬停逻辑，临时禁用插件可验证是否冲突

想保留提示但减少干扰？调延迟比直接关更实用

如果你偶尔需要悬停看一眼，又不想它“秒弹”，建议调高延迟而非彻底关闭：

• 在 Editor → General → Code Completion 页面，保持 Show the documentation popup 勾选状态
• 下方找到 Autopopup delay (ms)，把默认的 0 改成 500 或 800
• 这样只有悬停超过半秒才会弹出，手指划过时基本不触发

这个数值对不同人手感差异很大，300–1000 是较常见的调试区间。

真正容易被忽略的是：PyCharm 的文档弹窗依赖索引完整性。如果刚导入新库（比如 torch 或 fastapi），即使关了悬停，首次按 Ctrl+Q 也可能卡顿或空白——这不是设置问题，而是索引没刷完，等右下角状态栏的 “Indexing…” 消失后再试。