使用pyinstaller打包成exe文件后 出现错误ModuleNotFoundError: No module named 'matplotlib'

### 使用 PyInstaller 打包后出现 `ModuleNotFoundError: No module named 'matplotlib'` 的解决方案 当使用 PyInstaller 打包包含 `matplotlib` 的 Python 应用程序时，可能会出现 `ModuleNotFoundError: No module named 'matplotlib'` 的错误。这通常是因为 PyInstaller 未能正确识别并打包 `matplotlib` 模块及其依赖项，导致生成的可执行文件在运行时找不到该模块。 #### 解决方法 1. **确保 `matplotlib` 已正确安装** 在打包前，需要确保 `matplotlib` 已在当前 Python 环境中安装。可以使用以下命令安装： ```bash pip install matplotlib ``` 如果网络连接不稳定，可以使用国内镜像源加速安装过程： ```bash pip install matplotlib -i https://pypi.tuna.tsinghua.edu.cn/simple ``` 2. **使用 `--hidden-import` 参数手动包含 `matplotlib` 模块** 在某些情况下，PyInstaller 可能无法自动检测到 `matplotlib` 的所有依赖模块。可以通过 `--hidden-import` 参数手动指定需要包含的模块。例如： ```bash pyinstaller --onefile --hidden-import=matplotlib --hidden-import=matplotlib.backends.backend_pdf your_script.py ``` 这条命令会生成一个单文件的打包应用，并明确包含 `matplotlib` 及其 PDF 后端模块[^2]。 3. **编辑 `.spec` 文件以包含缺失的模块** 如果希望更精细地控制打包过程，可以编辑 PyInstaller 生成的 `.spec` 文件。在 `a = Analysis(...)` 行中找到 `hiddenimports=[]` 参数，并在其中添加 `matplotlib` 及其相关模块： ```python a = Analysis(['your_script.py'], pathex=['path_to_your_script'], binaries=[], datas=[], hiddenimports=['matplotlib', 'matplotlib.backends.backend_pdf'], ...) ``` 保存 `.spec` 文件后，使用以下命令重新打包应用： ```bash pyinstaller your_script.spec ``` 4. **确保 PyInstaller 为最新版本** 为了获得最佳的兼容性和功能支持，建议使用最新版本的 PyInstaller。可以通过以下命令更新 PyInstaller： ```bash pip install --upgrade pyinstaller ``` 5. **检查打包后的依赖路径** 如果仍然遇到问题，可能需要检查打包后的依赖路径是否正确。可以使用以下代码验证 `matplotlib` 是否能够正常导入： ```python import matplotlib.pyplot as plt fig, ax = plt.subplots() ax.plot([1, 2, 3, 4], [1, 4, 2, 3]) plt.show() ``` 如果代码运行正常，说明问题已解决。 --- ### 相关问题 1. 如何在使用 PyInstaller 打包时处理未自动检测到的模块？ 2. 如何通过编辑 `.spec` 文件优化 PyInstaller 的打包过程？ 3. 如何确保 PyInstaller 打包的应用在不同环境中正常运行？ 4. 如何解决 PyInstaller 打包后出现的 `No module named 'matplotlib.backends.backend_tkagg'` 错误？ 5. 如何在打包过程中包含非二进制文件（如图片、配置文件等）？