必须在导入pyplot前执行matplotlib.use('agg')，改用savefig()保存图像；需确保figure活跃、关闭资源防泄漏，并配置中文字体与合适输出格式。
直接在无GUI的Linux服务器上运行 plt.show() 必然报错，核心解法就一条：禁用交互式后端，改用 Agg 并只走 savefig() 保存文件。
RuntimeError: Invalid DISPLAY variable 怎么快速修复
这是最典型的无界面报错，本质是matplotlib尝试调用GUI后端（如TkAgg）但系统没$DISPLAY。不靠环境变量硬改，最稳做法是代码里提前锁定后端：
-
matplotlib.use('Agg')必须在导入pyplot之前执行，顺序错了会静默失效 - 如果脚本被多进程调用（比如用
multiprocessing），把这行放进if __name__ == '__main__':块里，避免子进程重复设置出问题 - 别依赖
export MPLBACKEND=Agg，某些容器或CI环境里它会被覆盖或忽略
savefig() 保存失败或图片空白的常见原因
即使后端设对了，savefig() 还可能生成空图、模糊图或直接抛ValueError。关键不在函数本身，而在绘图上下文是否“活”着：
Python 3.14.2
下载
Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。
- 调用
savefig()前必须有活跃的figure对象——要么显式plt.figure()，要么用面向对象接口（fig, ax = plt.subplots()） - 别在
plt.show()后再调savefig()，show()会清空当前figure，后续保存就是空画布 - 中文标签乱码？不是字体问题，是
Agg后端默认不加载系统字体，加这两行：plt.rcParams['font.sans-serif'] = ['DejaVu Sans', 'simhei']和plt.rcParams['axes.unicode_minus'] = False
Agg 后端输出格式和性能要注意什么
Agg 是纯CPU光栅渲染，适合批量出图，但格式选错会影响清晰度和体积：
- 导出
PNG最通用，但放大后锯齿明显；需要高清图优先用PDF或SVG（需提前设matplotlib.use('PDF')） -
savefig(dpi=300)能提清，但dpi超过600时文件体积激增，且服务器CPU压力明显上升 - 批量画百张图时，记得在循环里用
plt.close(fig)或plt.close('all')，否则内存泄漏导致OOM
真正容易被忽略的是：很多脚本在本地开发时混用了plt.plot()和ax.plot()，到了服务器上因为figure生命周期管理不一致，某次保存突然变空——统一用面向对象接口（fig, ax = plt.subplots()）能避开90%的隐性状态问题。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
