pycharm 中鼠标悬停弹出的代码预览窗是 quick documentation 功能，由 settings → editor → general → other 中的“show quick documentation on mouse move”控制，取消勾选即可禁用自动触发，但不影响 ctrl+q 手动调用。

PyCharm 里鼠标悬停弹出的代码预览窗是什么

那是 Quick Documentation（快速文档）功能，不是“悬浮窗”本身，而是 PyCharm 主动调用的文档弹层。它默认绑定在鼠标悬停（hover）动作上，底层依赖于 Ctrl+Q 快捷键触发的同一机制。关掉它，本质是禁用 hover 触发，而非关闭某个独立窗口。

关闭 hover 触发的 Quick Documentation

进入 Settings/Preferences → Editor → General → Other，找到 Show quick documentation on mouse move 这个复选框，取消勾选即可。注意：这个选项只控制「鼠标移动时自动弹出」，不影响你手动按 Ctrl+Q 调用。

• 如果勾选了但延迟很高，可同步调整下方的 Delay (ms)，设为 0 或 500 以上——设太低容易误触，太高又显得卡顿
• macOS 用户路径是 PyCharm → Preferences → Editor → General → Other
• 该设置对所有语言生效，包括 Python、JavaScript、Java 等，不区分项目

为什么关了还偶尔弹出来

常见原因有两个：Quick Definition（快捷定义）和 Parameter Info（参数提示）也共用类似悬浮逻辑，但它们是独立开关。

PyCharm 2026.2

PyCharm 2026.2提供 JetBrains 官方 2026.2 版本安装包，适合需要指定 PyCharm 版本进行 Python 项目开发、运行和调试的用户。

下载

• 禁用定义悬浮：取消勾选 Settings → Editor → General → Other → Show quick definition on mouse move
• 禁用参数提示悬浮：去 Settings → Editor → General → Code Completion，关闭 Show the parameter info popup（这个只在输入括号时出现，但有时会被误认为是文档悬浮）
• 某些插件（如 Rainy Day、Markdown Navigator）也会注入自己的 hover 行为，检查 Settings → Plugins 中是否有可疑插件

临时隐藏比永久关闭更实用的场景

开发中经常需要临时查看，但又不想被频繁打断，这时不必彻底关掉，改用快捷键更可控：

• 按住 Ctrl（Windows/Linux）或 Cmd（macOS）再悬停，可临时启用 hover 文档（前提是上面的自动触发已开启）
• 按 Ctrl+Shift+I 弹出内联文档（Inline Documentation），内容更精简，不遮挡代码
• 按 Ctrl+Q 呼出完整文档窗口，支持滚动、复制、跳转，比悬浮窗可靠得多

真正麻烦的是 hover 和代码补全弹窗同时弹出、互相遮挡——这时候优先关掉 hover，保留补全，别为了“看起来清爽”把所有提示都关光，反而降低效率。