GitHub Codespaces中Matplotlib无法生成图表的问题求助

为什么Codespaces里Matplotlib图表不显示？ #

这不是Codespaces的限制，而是Matplotlib的后端配置问题。本地环境默认使用带GUI的后端（如TkAgg、Qt5Agg），但Codespaces是云端无头（headless）环境，没有图形界面渲染弹出窗口，因此代码无报错但不会显示图表窗口。官方镜像确实预装了Matplotlib，但默认后端不适配云端环境。

解决方法 #

1. 修改Matplotlib后端为inline模式（推荐） #

在代码开头添加配置，让图表直接嵌入到VS Code输出面板或Jupyter环境中：

import matplotlib.pyplot as plt
# 切换为适合无头环境的后端
plt.switch_backend('Agg')
# 若使用Jupyter环境，添加此行让图表内嵌显示
%matplotlib inline

• 纯Python脚本：配置后用plt.savefig('scatter_plot.png')将图表保存为图片，在Codespaces文件浏览器中打开查看即可。
• VS Code交互式窗口：配置后图表会直接显示在输出区域，无需额外操作。

2. 使用VS Code交互式窗口运行代码 #

在Codespaces的VS Code中，通过Shift+Enter逐行运行代码，或右键选择「Run in Interactive Window」，Matplotlib会自动适配云端环境，图表直接显示在输出面板里，无需手动修改后端。

3. 改用云端友好的绘图库 #

如果不想调整Matplotlib配置，可替换为更适配云端的可视化库：

• Plotly：生成交互式图表，直接在浏览器或VS Code中显示，无需后端配置
• Seaborn：基于Matplotlib，只需配置Matplotlib为inline后端即可正常显示
• Altair：声明式可视化库，输出的图表可直接在Codespaces预览中打开

验证配置有效性 #

可添加以下代码确认后端是否修改成功：

print(plt.get_backend())

若输出为module://matplotlib_inline.backend_inline或Agg，说明配置正确。

内容的提问来源于stack exchange，提问作者Marcel Gruber