包含多个UI文件的PyQt5 GUI用PyInstaller打包exe报错如何解决

触发该报错的核心原因是PyInstaller的spec文件中datas参数格式不符合要求：
datas参数接收的列表中，每个元素必须是长度为2的元组，格式为(资源在本地的源路径, 打包后在程序临时目录中的存放路径)。你直接传入了仅包含单个文件路径字符串的列表，PyInstaller遍历datas时尝试把每个元素拆成源路径、目标路径两个变量赋值，自然会触发“too many values to unpack (expected 2)”的解包错误。
另外你贴的代码里还有一个隐藏问题：类定义外的form_ui = uic.loadUiType("ui\\user_view.ui")[0]这行代码没有使用你定义的resource_path函数包裹路径，就算spec配置改对，打包后运行时还是会因为找不到UI文件报错。

1. 修正所有资源加载的路径写法 #

所有加载UI、图片、配置文件的代码，都必须用resource_path函数拼接路径，类定义外的加载逻辑也不能遗漏。以你的user_view_ui.py为例，修正后的代码如下：

import sys
import os
from PyQt5 import uic
from PyQt5.QtWidgets import QMainWindow

def resource_path(relative_path):
    """ Get absolute path to resource, works for dev and for PyInstaller """
    base_path = getattr(sys, '_MEIPASS', os.path.dirname(os.path.abspath(__file__)))
    return os.path.join(base_path, relative_path)

# 必须用resource_path包裹UI路径，不要硬写相对路径
form_ui = uic.loadUiType(resource_path(os.path.join("ui", "user_view.ui")))[0]

class UserViewUi(QMainWindow, form_ui):
    def __init__(self):
        super().__init__()
        self.setupUi(self)
    # 其余业务逻辑保持不变

项目内其他Python文件的UI加载逻辑，全部按照这个规则修改，统一用resource_path拼接路径。

2. 修正spec文件的datas配置 #

datas列表内每个条目都要写成(本地源路径, 打包后目标目录)的元组，为了减少路径匹配问题，打包后的目录结构尽量和本地开发时的结构保持一致即可。修正后的配置如下：

# 单个UI文件逐个配置的写法
ui_list = [
    ('.\\ui\\user_view.ui', '.\\ui'),
    ('.\\ui\\change_list_view.ui', '.\\ui'),
    ('.\\ui\\move_to_another_changelist.ui', '.\\ui'),
    ('.\\ui\\login.ui', '.\\ui'),
    ('.\\ui\\user_settings.ui', '.\\ui')
]

a = Analysis(
    ['user_view_ui.py'],
    pathex=[],
    binaries=[],
    datas=ui_list,
    # 其余参数保持PyInstaller自动生成的默认值即可，无需修改
    hiddenimports=[],
    hookspath=[],
    hooksconfig={},
    runtime_hooks=[],
    excludes=[],
    win_no_prefer_redirects=False,
    win_private_assemblies=False,
    cipher=None,
    noarchive=False
)
# 后续PYZ、EXE、COLLECT配置段保持默认内容即可

如果嫌逐个列UI文件麻烦，也可以直接把整个ui文件夹打包进去，不用单独列每个文件：

ui_list = [('.\\ui', '.\\ui')]

3. 执行打包命令 #

在spec文件所在目录执行打包命令即可：

pyinstaller --onefile user_view_ui.spec

• 不要把resource_path函数定义在if __name__ == '__main__'代码块内，要保证所有资源加载逻辑都能正常调用该函数
• 路径拼接优先使用os.path.join，不要硬编码斜杠/反斜杠，避免跨环境路径兼容问题
• 首次打包建议保留控制台窗口（即EXE配置段中console=True），如果运行exe时报错可以直接看到错误信息，方便排查，等程序运行正常后再改成无控制台模式
• 如果打包后提示找不到UI资源，先逐行检查所有UI加载位置是否都用resource_path包裹了路径，再核对spec文件中datas配置的目标目录和代码内写的相对路径是否匹配

内容的提问来源于stack exchange，提问作者seonguk.jeon