Ubuntu 20.04环境下运行matplotlib代码无可视化输出问题求助

一、最简功能验证测试用例 #

直接运行下方无额外依赖的代码即可验证matplotlib安装是否正常：

import matplotlib
# 打印当前使用的后端，方便后续排查
print("当前matplotlib后端：", matplotlib.get_backend())
import matplotlib.pyplot as plt

# 绘制最简单的折线图
plt.plot([1, 2, 3, 4], [15, 23, 17, 30])
plt.title("安装验证测试图")
# 触发弹窗渲染，必须添加
plt.show()

如果运行后能正常弹出带折线图的窗口，说明matplotlib安装无问题，否则为环境或后端配置问题。

二、问题排查方向 #

• 检查代码是否缺少plt.show()调用：你提供的示例代码末尾没有添加plt.show()触发窗口渲染，这是无报错无输出的最常见原因，补上该语句后优先测试。如果是在Jupyter类环境中运行，可添加%matplotlib inline开启行内渲染，无需调用show即可显示图片。
• 手动指定TkAgg后端生效：即使已经安装TkAgg依赖，也需要在导入pyplot之前手动指定后端才会生效，调整代码导入顺序如下：

  import matplotlib
  matplotlib.use('TkAgg')
  import matplotlib.pyplot as plt
  

• 补全系统图形依赖：Ubuntu环境下运行matplotlib弹窗需要提前安装系统依赖，运行命令sudo apt update && sudo apt install python3-tk libx11-dev libxext-dev补全缺失的tk相关依赖包。
• 确认环境一致性：如果使用虚拟环境，需确认安装matplotlib、tk依赖的环境和运行代码的环境为同一个，可分别运行which python3和pip3 list | grep matplotlib核对Python路径和安装包版本匹配。
• 离线保存验证功能：如果弹窗问题暂时无法解决，可在代码绘图逻辑末尾添加plt.savefig("output.png")，运行后查看当前工作目录是否生成正常的图片文件，如果生成成功说明matplotlib绘图功能正常，仅弹窗相关的后端配置存在问题。

内容的提问来源于stack exchange，提问作者Jim Maas