当前位置：首页 > news >正文

【编程实践】Windows + PySide6 + Matplotlib 绘图时 WinError 32 的完整排查与解决方案

news 2026/6/3 12:36:00

1. 问题背景

在基于 PySide6（Qt）+ Matplotlib 开发桌面 GUI 程序时，需要在界面中动态生成 Matplotlib 图像，并显示在 QLabel 中。

程序功能表现为：

Matplotlib 图像可以正常绘制
图像可以正常显示在界面中
但在生成图像后，程序弹出错误提示：

// 提示信息 WinError 32: 另一个程序正在使用此文件，进程无法访问 C:\Users\xxx\AppData\Local\Temp\tmpxxxx.png

该错误并不会影响图像显示结果，但会中断后续逻辑，严重影响程序稳定性。

2. 初步误判与无效尝试

在排查过程中，最先怀疑的方向包括：

Matplotlib 后端问题（Qt5Agg / 默认后端）
plt.close(fig) 是否调用正确
是否需要切换为 Agg 后端
是否应避免使用系统临时目录

尝试过的方案包括：

显式调用 plt.close(fig)
移除 matplotlib.use(‘Qt5Agg’)
改用 fig.savefig()
改变临时文件保存路径
这些修改均无法彻底解决问题，说明问题不在 Matplotlib 后端本身。

3. 问题本质定位

最终定位发现，该问题是Windows 文件锁机制 + Qt 文件加载行为共同导致的结果。

3.1 关键代码模式（问题写法）

// pythontemp_file=tempfile.NamedTemporaryFile(suffix=".png",delete=False)plt.savefig(temp_file.name)pixmap=QPixmap(temp_file.name)os.unlink(temp_file.name)

（1）NamedTemporaryFile文件句柄未释放

在 Windows 系统中：

NamedTemporaryFile 在未关闭前
文件始终处于被占用状态
即使 delete=False，依然无法被其他进程安全删除

（2）QPixmap(file_path) 会锁定文件
QPixmap(path) 在 Windows 下会：

直接占用并锁定该文件
且不会在短时间内释放句柄
导致后续 os.unlink() 必然失败

两者叠加后，100% 触发 WinError 32。

4. 正确的解决方案

核心思想

Qt 显示图像应从内存加载，而不是直接从文件路径加载。

即：

文件只作为中转
Qt 只接触内存数据
文件可在加载后立即删除

4.1 推荐实现方式（稳定方案）

// pythonimporttempfileimportosfromPySide6.QtGuiimportQPixmap #1.生成临时文件路径（不保持打开状态） fd,tmp_path=tempfile.mkstemp(suffix=".png")os.close(fd)#2.使用 fig.savefig 写入文件 fig.savefig(tmp_path,dpi=150,bbox_inches="tight")#3.读入内存withopen(tmp_path,"rb")asf:img_bytes=f.read()#4.从内存加载到 QPixmap pixmap=QPixmap()pixmap.loadFromData(img_bytes)#5.显示 label.setPixmap(pixmap)#6.安全删除文件 os.remove(tmp_path)