export MPLBACKEND=Agg命令使用
目录
- 1️⃣ `export`
- 2️⃣ `MPLBACKEND`
- 3️⃣ `Agg` 是什么
- 4️⃣ 为什么要设置 `Agg`
- 5️⃣ 典型使用场景
- 6️⃣ Python等价写法
export MPLBACKEND=Agg是一个Linux / bash 环境变量设置命令，用于指定Python 的 Matplotlib 使用的绘图后端（backend）。
我们拆开解释：
1️⃣export
export是 Linux shell 的命令，用于设置环境变量，并让子进程继承。
例如：
exportA=10表示：
- 当前 shell 设置变量
A - 之后启动的程序（python、bash脚本等）都可以读取这个变量。
2️⃣MPLBACKEND
MPLBACKEND是Matplotlib 的环境变量，用于指定绘图后端。
Matplotlib 有很多 backend，例如：
| Backend | 作用 |
|---|---|
| TkAgg | GUI窗口绘图 |
| Qt5Agg | Qt GUI |
| MacOSX | macOS GUI |
| Agg | 无GUI，直接渲染图片 |
3️⃣Agg是什么
Agg指的是：
Anti-Grain Geometry
它是一个纯 CPU 的图像渲染引擎，特点：
- 不需要 GUI
- 不需要 X11
- 可以直接生成图片
常见输出：
png jpg svg pdf例如：
importmatplotlib.pyplotasplt plt.plot([1,2,3])plt.savefig("a.png")4️⃣ 为什么要设置Agg
在服务器 / Docker / CI / SSH 远程环境中，通常没有图形界面。
如果使用默认 backend：
TkAgg Qt5Agg就会报错：
cannot connect to X server或者：
RuntimeError: Invalid DISPLAY variable所以设置：
exportMPLBACKEND=Agg意思是：
让 Matplotlib 在无图形环境下运行，只生成图片，不打开窗口。
5️⃣ 典型使用场景
例如在Docker / 训练脚本：
exportMPLBACKEND=Agg python train.py或者：
MPLBACKEND=Agg python plot.py常见于：
- 机器学习训练日志画图
- CI pipeline
- 服务器绘图
- ROS / robot 可视化日志
6️⃣ Python等价写法
如果不想用环境变量，也可以在 Python 中写：
importmatplotlib matplotlib.use("Agg")然后再：
importmatplotlib.pyplotasplt⚠️ 注意顺序必须在pyplot之前。
✅一句话总结
export MPLBACKEND=Agg意思是：
让 Matplotlib 使用Agg 无GUI后端，在服务器或Docker中只生成图片，不弹出窗口。