PyInstaller打包NiceGUI单文件应用遇matplotlib模块缺失错误求助

问题分析 #

PyInstaller依赖静态代码分析识别应用依赖，但Matplotlib的后端模块（如backend_svg）是动态加载的，不会被自动检测到，导致打包后运行时出现模块缺失错误。

解决方案 #

在PyInstaller打包命令中添加--hidden-import参数，显式指定需要包含的Matplotlib后端模块，同时确保NiceGUI的资源路径正确。

修改后的build.py代码 #

import nicegui
from pathlib import Path
import subprocess
import os

static_dir = Path(nicegui.__file__).parent

cmd = [
    "py",
    "-m",
    "PyInstaller",
    "main.py",
    "--name",
    "myapp",
    "--onefile",
    # '--windowed', # 仅在ui.run(native=True,...)时使用，隐藏控制台
    "--add-data",
    f"{static_dir}{os.pathsep}nicegui",
    # 添加缺失的Matplotlib后端模块
    "--hidden-import",
    "matplotlib.backends.backend_svg",
    # 额外添加常用后端避免其他潜在问题
    "--hidden-import",
    "matplotlib.backends.backend_agg",
]
subprocess.call(cmd)

额外优化（可选） #

如果希望更稳妥，可以在main.py开头显式导入这些后端模块，帮助PyInstaller识别依赖：

import numpy as np
# 显式导入Matplotlib后端
import matplotlib.backends.backend_svg
import matplotlib.backends.backend_agg

from nicegui import ui

ui.label("Hello from Pyinstaller")

with ui.matplotlib(figsize=(3, 2)).figure as fig:
    x = np.linspace(0.0, 5.0)
    y = np.cos(2 * np.pi * x) * np.exp(-x)
    ax = fig.gca()
    ax.plot(x, y, "-")

ui.run(native=True, reload=False, title="PyInstaller Test")

验证步骤 #

1. 运行修改后的build.py完成打包
2. 进入dist目录，运行生成的myapp.exe（Windows）或对应可执行文件，确认应用正常显示Matplotlib图表

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