要彻底关闭pycharm鼠标悬停文档提示,需依次禁用三处设置:editor → general → other中取消“show quick documentation on mouse move”,editor → general → code completion中取消“show the parameter info popup”,以及editor → inlay hints → python中关闭parameter names和type hints等内联提示。

关闭鼠标悬停文档提示(Quick Documentation)
PyCharm 默认启用 Quick Documentation,鼠标悬停在函数、类或变量上时会弹出文档摘要。这不是“注释”本身,而是从源码 docstring 或 stubs 提取的文档快照。要彻底关掉它,不能只靠禁用代码补全,得单独处理这个功能。
- 打开
Settings/Preferences(macOS 是PyCharm → Preferences) - 进入
Editor → General → Other - 取消勾选
Show quick documentation on mouse move - 可顺手调整下方的
Delay (ms)—— 设为0也不起作用,但设成较大值(如1000)能缓解误触
为什么关了还弹?检查是否被 Parameter Info 干扰
有时候你以为关的是文档提示,实际弹出来的是参数信息框(比如输入 os.path.join( 后自动浮现的参数列表)。它和 Quick Documentation 是两个独立开关,容易混淆。
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包,下载地址指向官方 Windows 安装包直链,可用于旧项目兼容、版本回退和环境测试。
- 路径:
Editor → General → Code Completion - 确认已取消勾选
Show the parameter info popup - 该弹窗默认触发时机是「输入左括号后」,不是悬停,但视觉上很像,尤其当光标刚停在函数名末尾时
内联提示(Inlay Hints 不是悬停,但常被误认为“注释”
如果你看到的是函数参数名旁边浮出的 path、sep 这类灰色小字,那是 Inlay Hints,属于编辑器内联提示,和鼠标悬停无关,但用户常一并要求关闭。
- 路径:
Editor → Inlay Hints → Python - 取消勾选
Parameter names和Type hints等子项 - 注意:部分 hint 由插件(如
AI Assistant)提供,需额外去Tools → AI Assistant关闭Show inline suggestions
彻底静音:启用 Power Save Mode
如果只是临时需要专注、不想任何提示干扰,最省事的办法是开节能模式。它会停掉所有后台分析,包括悬停文档、参数提示、实时错误检查、代码补全等。
- 菜单栏点击
File → Power Save Mode(macOS 同样路径) - 状态栏会出现
Power Save Mode提示,所有悬停行为立即失效 - 缺点:关掉后
Ctrl+Click跳转、Alt+Enter快速修复等功能也会变迟钝或不可用
Other 里的文档、Code Completion 里的参数提示、Inlay Hints 里的内联标签。单独关一个,另外两个可能还在“冒头”,得挨个确认。










