PyCharm代码下方的灰色小圆点是Code Vision或Inlay Hints功能提示，非错误或断点；可分别在Inlay Hints和Code Vision设置中关闭函数调用、变量类型、引用计数等对应选项，调试模式、第三方插件或外部语言服务器也可能导致其残留。

PyCharm 里代码下方的灰色小圆点是什么

那是 PyCharm 的 Code Vision 功能标记，不是错误，也不是断点——它默认显示函数调用次数、测试覆盖率、类型推断来源等上下文信息。很多人误以为是语法问题或插件冲突，其实只是视觉干扰。

关闭灰色小圆点的最直接方式

这些圆点由多个子功能共同触发，不能靠“一键关闭所有”，得按需禁用：

• 进入 Settings > Editor > Inlay Hints > Python（macOS 是 Preferences > Editor > Inlay Hints > Python）
• 取消勾选 Show hints for function calls（影响 func(...) 下方的调用位置提示）
• 取消勾选 Show hints for variable types（影响变量赋值后出现的类型推断，如 name: str 那种小字）
• 如果还看到圆点，检查 Settings > Editor > Code Vision > References，关闭 Show reference count

为什么关了设置还是有小圆点

常见原因有三个：

PyCharm 2026.2

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

下载

• 你正在调试（Debug 模式），PyCharm 会临时显示 Breakpoint hit count —— 这个圆点颜色偏蓝灰，停在行号旁而非代码正下方；退出调试即可消失
• 装了第三方插件，比如 CodeGlance 或 GitToolBox，它们可能复用相同 UI 元素渲染自定义提示；可进 Settings > Plugins 临时禁用排查
• 项目启用了 PyRight 或 Pylance（尤其在 WSL 或远程解释器场景），它们通过 LSP 注入的 inlay hint 不受 PyCharm 原生设置控制；此时要改 pyrightconfig.json 或 VS Code 风格配置（即使你在用 PyCharm）

不建议全局关闭，但可以按文件/作用域临时隐藏

有些提示其实有用，比如快速看清 self.xxx 实际来自哪个父类。更稳妥的做法是：

• 把鼠标悬停在小圆点上，看 tooltip 说明它属于哪个功能（常带 Python、Testing、Git 标签）
• 右键点击圆点 → 选择 Disable 'xxx' hints in this file（选项名随提示类型变化）
• 对测试文件夹统一禁用：在 Project tool window 中右键 tests/ → Mark Directory as > Excluded，可避免覆盖率圆点干扰

真正麻烦的是那些混用 PyCharm 原生提示 + 外部语言服务器 + Git 插件的项目，圆点可能来自不同源头，得一个个 hover 确认再关——别指望一个开关全清掉。