PyInstaller打包PySide6浏览器时如何嵌入PNG图标并正常显示？

方法一：通过PyInstaller的--add-data参数携带图标文件 #

• 先把所有按钮图标（如back.png、forward.png）放到和browser.py同目录的icons文件夹中
• 修改打包命令，添加--add-data参数指定资源文件的打包规则：

  # Windows系统用分号分隔路径
  pyinstaller --onefile --windowed --name "MyBrowser" --icon "icon.ico" --add-data "icons/*;icons" browser.py
  # macOS/Linux系统用冒号分隔路径
  pyinstaller --onefile --windowed --name "MyBrowser" --icon "icon.ico" --add-data "icons/*:icons" browser.py
  

• 在代码中动态获取图标路径，适配打包前后的环境：

  import sys
  import os
  from PySide6.QtWidgets import QPushButton
  from PySide6.QtGui import QIcon
  
  def get_icon_path(relative_path):
      # 打包后程序会解压到临时目录，用sys._MEIPASS获取该路径
      if hasattr(sys, '_MEIPASS'):
          return os.path.join(sys._MEIPASS, relative_path)
      # 未打包时直接用当前目录的相对路径
      return os.path.join(os.path.abspath("."), relative_path)
  
  # 示例：初始化返回按钮
  back_btn = QPushButton()
  back_btn.setIcon(QIcon(get_icon_path("icons/back.png")))
  

方法二：将图标转为Base64嵌入代码（无额外文件） #

这种方式不需要携带外部图标文件，所有资源都嵌入exe中，适合分发：

• 先把图标文件转成Base64字符串，可通过以下脚本生成：

  import base64
  
  # 替换为你的图标路径
  with open("icons/back.png", "rb") as f:
      back_icon_b64 = base64.b64encode(f.read()).decode('utf-8')
  print(back_icon_b64)
  

• 把生成的Base64字符串直接写入代码，通过QPixmap加载：

  from PySide6.QtWidgets import QPushButton
  from PySide6.QtGui import QIcon, QPixmap
  from PySide6.QtCore import QByteArray
  
  # 直接嵌入Base64格式的图标数据
  BACK_ICON_B64 = "这里替换为生成的Base64字符串"
  
  def load_icon_from_b64(b64_str):
      byte_data = QByteArray.fromBase64(b64_str.encode('utf-8'))
      pixmap = QPixmap()
      pixmap.loadFromData(byte_data)
      return QIcon(pixmap)
  
  # 示例：初始化前进按钮
  forward_btn = QPushButton()
  forward_btn.setIcon(load_icon_from_b64(BACK_ICON_B64))
  

调试小技巧 #

• 如果打包后图标仍不显示，可以暂时去掉--windowed参数，运行exe时查看控制台输出的路径错误，定位问题
• 测试时务必把exe放到没有Python和PySide6环境的电脑上验证，确保分发正常

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