使用PyInstaller打包Tkinter脚本为单EXE时任务栏图标加载失败求助

你遇到的问题根源有两个：

1. 你用的pyinstaller --onefile -i "icon.ico"命令中，-i参数仅用于设置EXE文件自身的图标（也就是文件管理器里显示的那个图标），并没有把icon.ico打包进单文件EXE内部供Tkinter调用。
2. 单文件EXE运行时会自动解压到系统临时目录，但你的代码里self.iconbitmap('icon.ico')是在当前工作目录查找图标文件，而临时目录里并没有这个文件，所以触发TclError。

以下两种方法都能实现单文件EXE运行时正常显示任务栏/窗口图标：

方法1：用--add-data打包图标并处理路径 #

步骤1：修改PyInstaller打包命令 #

添加--add-data参数把图标打包进EXE，Windows下用分号分隔源路径和目标路径：

pyinstaller --onefile -i "icon.ico" --add-data "icon.ico;." my-script.py

步骤2：修改代码获取正确的图标路径 #

添加路径处理逻辑，判断程序是否处于PyInstaller打包后的运行环境，自动切换图标路径：

import tkinter as tk
import sys
import os

def get_resource_path(relative_path):
    try:
        # 打包后，PyInstaller会把资源解压到sys._MEIPASS指向的临时目录
        base_path = sys._MEIPASS
    except Exception:
        # 未打包时，使用当前工作目录
        base_path = os.path.abspath(".")
    return os.path.join(base_path, relative_path)

class Application(tk.Tk):
    def __init__(self, title:str="Simple", x:int=0, y:int=0, **kwargs):
        tk.Tk.__init__(self)
        self.title(title)
        self.config(**kwargs)
        # 使用处理后的图标路径
        self.iconbitmap(get_resource_path('icon.ico'))
        self.first_row_frame=tk.Frame(self)
        self.first_row_frame.grid(column=0,row=0,sticky='W')
        self.lbl_ser_num=tk.Label(self.first_row_frame,text="Sr No:",font='Arial 50 bold')
        self.lbl_ser_num.grid(column=0,row=0)
        self.update_idletasks()
        self.state('zoomed')

if __name__ == "__main__":
    Application(title="simple app").mainloop()

方法2：将图标转为Base64嵌入代码（完全单文件） #

这种方法不需要额外打包参数，直接把图标编码后写入代码，运行时临时生成图标文件：

步骤1：生成图标的Base64编码 #

运行以下脚本，复制输出的字符串：

import base64

with open("icon.ico", "rb") as f:
    icon_base64 = base64.b64encode(f.read()).decode('utf-8')

print(icon_base64)

步骤2：修改代码嵌入Base64编码 #

import tkinter as tk
import base64
import os
import tempfile

class Application(tk.Tk):
    def __init__(self, title:str="Simple", x:int=0, y:int=0, **kwargs):
        tk.Tk.__init__(self)
        self.title(title)
        self.config(**kwargs)
        
        # 替换成你刚才生成的Base64字符串
        icon_base64 = "替换为你的图标Base64编码"
        # 临时创建ICO文件
        with tempfile.NamedTemporaryFile(delete=False, suffix='.ico') as tmp:
            tmp.write(base64.b64decode(icon_base64))
            tmp_path = tmp.name
        
        self.iconbitmap(tmp_path)
        # 程序退出时删除临时文件
        self.protocol("WM_DELETE_WINDOW", lambda: self.cleanup(tmp_path))
        
        self.first_row_frame=tk.Frame(self)
        self.first_row_frame.grid(column=0,row=0,sticky='W')
        self.lbl_ser_num=tk.Label(self.first_row_frame,text="Sr No:",font='Arial 50 bold')
        self.lbl_ser_num.grid(column=0,row=0)
        self.update_idletasks()
        self.state('zoomed')
    
    def cleanup(self, tmp_path):
        self.destroy()
        os.unlink(tmp_path)

if __name__ == "__main__":
    Application(title="simple app").mainloop()

• 方法1：图标可独立修改，无需改动代码，适合需要频繁更换图标的场景。
• 方法2：完全无额外依赖，EXE是绝对独立的单文件，适合需要极简分发的场景。

• Windows下Tkinter的iconbitmap仅支持ICO格式，确保你的图标是有效ICO文件。
• 重新打包前建议删除旧的build、dist文件夹和.spec文件，避免缓存干扰。

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