如何将带PyQt5等依赖的Python项目打包为单可执行文件

一、处理.ui文件的两种方案（无需担心代码崩溃） #

方案1：将.ui文件转换为.py文件（推荐） #

这是最稳定的处理方式，转换过程不会破坏原有逻辑：

• 激活你的虚拟环境，执行转换命令：

  pyuic5 myGUI.ui -o myGUI.py
  

• 修改main.py中的UI加载代码：
  原代码：

  uic.loadUi("myGUI.ui", self)
  

  替换为：

  from myGUI import Ui_MainWindow  # 类名对应.ui文件中定义的主窗口类，默认是Ui_+窗口名，打开生成的myGUI.py即可确认
  self.ui = Ui_MainWindow()
  self.ui.setupUi(self)
  

方案2：直接打包.ui文件（无需修改UI结构） #

如果不想转换，只需调整路径获取逻辑，确保打包后能正确找到.ui文件：

• 在main.py中添加路径处理函数：

  import sys
  import os
  from PyQt5 import uic
  
  def get_resource_path(relative_path):
      # 获取打包后的临时资源路径
      try:
          base_path = sys._MEIPASS
      except AttributeError:
          # 开发环境下使用当前路径
          base_path = os.path.abspath(".")
      return os.path.join(base_path, relative_path)
  

• 修改UI加载代码为：

  uic.loadUi(get_resource_path("myGUI.ui"), self)
  

二、使用PyInstaller打包为单可执行文件 #

步骤1：安装PyInstaller #

在激活的虚拟环境中执行：

pip install pyinstaller

步骤2：执行打包命令 #

根据你选择的.ui处理方案，执行对应命令：

• 若用方案1（已转.py）：

  pyinstaller --onefile main.py
  

• 若用方案2（保留.ui）：
  • Windows系统：

    pyinstaller --onefile --add-data "myGUI.ui;." main.py
    

  • Mac/Linux系统：

    pyinstaller --onefile --add-data "myGUI.ui:." main.py
    

  （如果有多个.ui文件，重复--add-data参数即可，例如--add-data "ui1.ui;." --add-data "ui2.ui;."）

步骤3：测试可执行文件 #

打包完成后，可执行文件会生成在项目根目录的dist文件夹中，直接运行即可。如果出现依赖缺失的报错，可通过--hidden-import参数手动添加，例如：

pyinstaller --onefile --hidden-import numpy.core._methods main.py

三、额外优化建议 #

• 打包前清理虚拟环境，只保留项目必需的依赖（PyQt5、numpy、pyinstaller），可大幅减小可执行文件体积
• 添加应用图标：使用--icon=your_icon.ico参数（Windows用.ico格式，Mac用.icns格式）
• Windows下若出现杀毒软件误报，可添加数字签名（内部使用可忽略）

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