使用PyInstaller打包Tkinter程序时遇Matplotlib SVG后端模块缺失问题

我开发了一个基于Tkinter界面的程序，支持从Excel或CSV文件生成图表并自动保存。使用PyInstaller打包后，程序运行时仅在保存图片环节报错，其余功能均正常，报错信息如下：

ModuleNotFoundError: No module named "matplotlib.backends.backend_svg"
Failed to execute script "myscript.py" due to unhandled exception!

已知这是PyInstaller与Matplotlib后端的兼容问题，尝试过以下方法但未解决：

• 卸载重装并更新Matplotlib
• 在代码中手动导入matplotlib.backends.backend_tkagg

还找到过两段PyInstaller打包相关的示例代码，但不清楚其作用，直接添加到代码开头也无效：

示例A（资源路径处理） #

try:
    # PyInstaller creates a temp folder and stores path in _MEIPASS
    base_path = sys._MEIPASS
except AttributeError:
    # If not running from a PyInstaller bundle, use the current working directory
    base_path = os.path.abspath(".")

# Append the filename (e.g., "ffmpeg.exe") to the base path
ffmpeg_path = os.path.join(base_path, "ffmpeg.exe")

示例B（NLTK数据集打包） #

import nltk                                              # hook for nltk
from PyInstaller.utils.hooks import collect_data_files   # add datas for nltk

datas = collect_data_files('nltk', False)

for p in nltk.data.path:                                 # loop through the data directories and add them
    if os.path.exists(p):
        datas.append((p, "nltk_data"))

经排查，问题大概率和SVG格式相关，常规后端无法处理SVG文件导致打包时遗漏了对应模块。

可行解决方案 #

方案1：手动导入SVG后端模块 #

在你的主脚本开头主动导入backend_svg模块，让PyInstaller的静态分析能检测到这个依赖：

import matplotlib.backends.backend_svg

添加后重新打包即可。

方案2：打包时指定隐藏导入参数 #

如果不想修改代码，直接在PyInstaller打包命令中加入--hidden-import参数，强制包含SVG后端模块：

pyinstaller --hidden-import matplotlib.backends.backend_svg your_script.py

方案3：编写PyInstaller钩子文件（进阶） #

如果需要确保Matplotlib所有后端都被打包，避免后续出现其他模块缺失问题，可以创建钩子文件：

1. 在项目目录下新建hook-matplotlib.backends.py文件，内容如下：

from PyInstaller.utils.hooks import collect_submodules

# 收集matplotlib.backends下所有子模块
hiddenimports = collect_submodules('matplotlib.backends')

2. 打包时指定钩子文件所在目录：

pyinstaller --additional-hooks-dir=. your_script.py

对找到的示例代码的说明 #

• 示例A：用于处理PyInstaller打包后的资源文件路径问题，和你的后端模块缺失无关。程序打包后，资源文件会被放在临时目录_MEIPASS，这段代码是获取正确的资源路径。
• 示例B：用于打包NLTK的数据集文件，属于数据资源打包场景，和你的模块依赖问题不相关。

额外建议 #

如果不需要保存为SVG格式，可以尝试修改代码中保存图片的格式为PNG或JPG，这样会使用Matplotlib的默认后端，也能绕过这个问题。

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