企业官网建设流程全解析

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)

5. 为什么这种方式是“稳妥解方案”

这是PySide / PyQt 在 Windows 下加载临时图像的标准工程写法。

6. 常见错误总结（避坑清单）

×不推荐写法

QPixmap(“xxx.png”)

• NamedTemporaryFile(delete=False) 不关闭

• plt.savefig() 混用 pyplot 状态

• 绘图后立即 os.unlink()

√推荐写法

• fig.savefig()

• mkstemp + os.close(fd)

• QPixmap.loadFromData(bytes)

• 文件仅作为中转

7. 总结

本次问题并非 Matplotlib 绘图错误，而是：

Windows 文件锁机制 + Qt 图像加载方式 + 临时文件管理不当共同导致的典型 GUI 工程级问题。

通过将Qt 图像加载从“文件路径”切换为“内存数据”，问题得以彻底解决。

该经验适用于：

• PySide6 / PyQt5 / PyQt6
• Matplotlib / Pillow / OpenCV 生成的临时图像
• 所有 Windows 桌面 GUI 项目