PyInstaller打包独立PyQt5窗体应用时UI文件路径配置问题咨询

PyInstaller的--onefile模式运行时会将所有依赖解压到系统临时目录的随机文件夹，运行结束后自动删除。你原先用Path('welcome.ui').resolve()是相对于程序运行时的当前工作目录（双击exe的话就是exe所在文件夹），而ui文件被打包在临时解压目录里，自然找不到。

1. 修改代码路径逻辑 #

适配开发环境和打包后的运行环境，代码修改如下：

import sys
from PyQt5.uic import loadUi
from PyQt5 import QtWidgets
from PyQt5.QtWidgets import QDialog, QApplication
from pathlib import Path

def get_base_path():
    # 打包后运行时使用PyInstaller自动设置的MEIPASS路径
    if getattr(sys, '_MEIPASS', False):
        return Path(sys._MEIPASS)
    # 开发环境下使用当前脚本所在目录
    return Path(__file__).parent

welcome = get_base_path() / 'welcome.ui'

class WelcomeScreen(QDialog):
  ''' Form a object by inheriting the QDialog'''
  def __init__(self):
    super(WelcomeScreen, self).__init__() # instantiate the object
    loadUi(welcome.resolve(), self)

# main
app = QApplication(sys.argv)
welcome = WelcomeScreen()
widget = QtWidgets.QStackedWidget()
widget.addWidget(welcome)
widget.setFixedHeight(800)
widget.setFixedWidth(1200)
widget.show()

try:
  sys.exit(app.exec_())
except:
  print("Existing")

2. 修改打包命令 #

添加--add-data参数将ui文件一起打包进程序：

• Windows系统命令：

pyinstaller --onefile --windowed --noconsole --add-data "welcome.ui;." main.py

• macOS/Linux系统命令：

pyinstaller --onefile --windowed --noconsole --add-data "welcome.ui:." main.py

参数末尾的;./:.表示将ui文件放到打包后的程序根目录，和代码中的路径逻辑对应。

直接把ui文件预编译为Python代码，不需要动态加载，也不用打包时额外配置参数：

1. 运行命令转换ui文件：

pyuic5 welcome.ui -o ui_welcome.py

2. 修改代码直接导入编译后的界面类：

import sys
from PyQt5 import QtWidgets
from PyQt5.QtWidgets import QDialog, QApplication
from ui_welcome import Ui_Dialog # 导入转换后的界面类

class WelcomeScreen(QDialog, Ui_Dialog):
  def __init__(self):
    super(WelcomeScreen, self).__init__()
    self.setupUi(self) # 直接调用内置方法加载界面

# 主逻辑不变
app = QApplication(sys.argv)
welcome = WelcomeScreen()
widget = QtWidgets.QStackedWidget()
widget.addWidget(welcome)
widget.setFixedHeight(800)
widget.setFixedWidth(1200)
widget.show()

try:
  sys.exit(app.exec_())
except:
  print("Existing")

3. 用你原来的打包命令直接打包即可，不需要添加任何额外参数。
   该方案优势是完全不用处理路径问题，适合接入CI/CD流水线的场景，缺点是每次修改ui文件后都要重新运行一次转换命令。

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