PyInstaller打包的Python可执行程序跨系统运行报错（图标问题）

问题本质 #

你遇到的报错是因为--onefile模式下，PyInstaller会将所有资源打包为单个可执行文件，运行时临时解压到系统临时目录。但你的代码中图标路径是本地相对/绝对路径，其他系统不存在该路径，导致CustomTkinter调用iconbitmap时找不到图标文件。

具体解决方案 #

1. 修改代码中的图标路径逻辑

利用PyInstaller提供的sys._MEIPASS变量获取临时解压目录，确保打包后能正确找到图标：

import sys
import os
import customtkinter as ctk

def get_icon_path():
    # 打包运行时用临时目录，本地调试用当前脚本所在目录
    base_path = sys._MEIPASS if hasattr(sys, '_MEIPASS') else os.path.dirname(__file__)
    return os.path.join(base_path, "your_icon.ico")  # 替换为你的图标文件名

# 初始化窗口并设置图标
app = ctk.CTk()
app.iconbitmap(get_icon_path())

# 后续业务代码
app.mainloop()

2. 更新PyInstaller打包命令

需要明确告诉PyInstaller将图标文件作为额外资源打包进去，命令调整为：

# Windows系统用分号分隔路径
pyinstaller --onefile --noconsole --add-data "your_icon.ico;." app1.py

# macOS/Linux系统用冒号分隔路径
pyinstaller --onefile --noconsole --add-data "your_icon.ico:." app1.py

3. （可选）用spec文件更灵活控制

如果需要频繁打包或配置更多参数，建议使用spec文件：

1. 生成初始spec文件：

pyinstaller --onefile --noconsole app1.py

2. 打开app1.spec，在datas列表中添加图标资源：

datas=[('your_icon.ico', '.')],

3. 基于spec文件打包：

pyinstaller app1.spec

额外注意事项 #

• Windows系统图标需为ico格式，macOS建议使用icns格式，跨平台可通过判断系统加载对应格式图标
• 本地调试时，确保图标文件与脚本在同一目录，或路径配置正确

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