Python PyInstaller 打包 UI 路径配置与加载指南

不晚

发布时间：2026-10-13| 6人浏览过

原创

本文介绍使用 PyInstaller 打包 Python 应用时如何正确加载 UI 文件。通过 --add-data 参数指定资源路径，并在代码中利用 sys._MEIPASS 获取打包后的临时目录，从而解决 UI 文件找不到或路径错误的问题。

PyInstaller 打包 UI 路径配置与加载指南

在将 Python 应用程序打包为可执行文件时，资源文件的路径处理是一个常见难点。


class Login(QMainWindow):
  """登录窗口"""
  global status_s
  global connect_signal
  def __init__(self, *args):
    super(Login, self).__init__(*args)
    
    if getattr(sys,'frozen',False):
      bundle_dir = sys._MEIPASS
    else:
      bundle_dir = os.path.dirname(os.path.abspath(__file__))
    loadUi(bundle_dir+'\set_controller.ui', self)

当使用 PyInstaller 进行封装时，需要在打包命令中明确指定 UI 文件的位置。

对于不带图形界面的后台程序，可以使用以下命令进行打包：pyinstaller -w -F --add-data="set_controller.ui;." .\jiaben.py

若需要保留控制台窗口，则使用带命令行界面的打包命令：pyinstaller -c -F --add-data="set_controller.ui;." .\jiaben.py

如果应用包含自定义图标，可以在生成的 spec 文件中添加图标配置，随后通过运行 pyinstaller **.spec 命令来完成打包。

以上即为 Python 中使用 PyInstaller 加载 UI 路径的主要方法，供开发者参考。