PyInstaller打包PyQt程序：如何将自定义按钮图标嵌入可执行文件

1. 修正打包命令 #

原命令存在多余括号、--add-data路径分隔符错误、重复参数问题，以下是适配不同系统的正确命令：

Windows系统： #

pyinstaller --clean --onefile --noconsole --icon="media/icon.png" --add-data="media/*;media" main.py

Mac/Linux系统： #

pyinstaller --clean --onefile --noconsole --icon="media/icon.png" --add-data="media/*:media" main.py

2. 调整代码中图标加载逻辑 #

单文件打包后，程序运行时会将资源解压到系统临时目录，不能直接用相对路径，必须通过sys._MEIPASS获取临时路径，示例代码如下：

import sys
import os
from PyQt5.QtWidgets import QPushButton, QApplication
from PyQt5.QtGui import QIcon

def get_resource_path(relative_path):
    # 适配打包前后的资源路径
    try:
        base_path = sys._MEIPASS  # 打包后临时目录路径
    except Exception:
        base_path = os.path.abspath(".")  # 未打包时的项目根目录
    return os.path.join(base_path, relative_path)

app = QApplication(sys.argv)
btn = QPushButton("带自定义图标的按钮")
# 替换为你的按钮图标文件名
icon_path = get_resource_path("media/btn_custom_icon.png")
btn.setIcon(QIcon(icon_path))
btn.show()
sys.exit(app.exec_())

3. 关键注意事项 #

• 确保media目录下的图标文件存在，代码中指定的文件名与实际一致
• 调试时可先去掉--onefile参数，以文件夹模式打包确认图标正常显示后，再打包单文件
• 禁止使用绝对路径加载资源，否则打包后会找不到文件

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