PyCharm无法正常显示matplotlib axd对象代码补全如何解决？

问题核心原因：PyCharm默认静态类型推断无法识别plt.subplot_mosaic返回字典中值的具体类型，无法匹配到对应Axes对象的方法，导致补全结果无效。

PyCharm精准补全开启方法 #

• 手动添加类型标注
  导入Axes类型后给axd加明确的类型标注即可让PyCharm识别字典值类型：

from matplotlib.axes import Axes
import matplotlib.pyplot as plt
import numpy as np

x = np.linspace(0, 2 * np.pi, 400)
y = np.sin(x ** 2)

# 明确标注axd的类型为键是字符串、值为Axes对象的字典
fig, axd: dict[str, Axes] = plt.subplot_mosaic([['left', 'right'],['bottom', 'bottom']],
                              constrained_layout=True)

后续输入axd['bottom'].时即可正常展示所有Axes对象的可调用方法。如果仅需要单次补全，也可以用临时类型断言：ax: Axes = axd['bottom']，后续输入ax.即可触发正常补全。

• 安装类型 stub 文件
  执行命令pip install types-matplotlib安装matplotlib的官方类型标注文件，可大幅提升PyCharm静态类型推断的准确率，不需要额外加标注也能识别大部分常用库的返回类型。
• 开启增强补全选项
  打开PyCharm设置→编辑器→代码完成，勾选「智能类型推断补全」、「收集运行时类型信息以改进补全」，运行一次代码后PyCharm会收集运行时的实际类型，补全精度会明显提升，专业版用户可额外开启动态类型分析功能。

适配的替代编辑器推荐 #

• VS Code：搭配Python、Pylance插件，默认静态类型推断能力优于PyCharm社区版，对matplotlib等常用库的动态返回类型支持更好，开启Pylance基础类型检查后即可获得非常精准的补全效果，工具免费。
• VSCodium：VS Code的完全开源版本，无内置遥测，插件生态和补全体验与VS Code完全一致。
• Neovim：搭配nvim-lspconfig和pyright语言服务器，资源占用低、自定义程度高，类型推断基于pyright实现，补全准确率高，适合习惯键盘操作的用户。

内容的提问来源于stack exchange，提问作者Martin Kunze