PyInstaller打包Tkinter程序时图标加载报错求助

问题分析 #

你遇到的_tkinter.TclError: bitmap "icon005.ico" not defined错误，核心原因是打包成单文件后，程序运行时会把资源解压到临时目录，代码里的相对路径icon005.ico无法定位到正确位置。另外直接用--icon参数只会设置exe本身的图标，不会自动把图标文件打包进程序里供Tkinter调用。

解决方案 #

1. 修改PyInstaller打包命令

添加--add-data参数把图标文件打包进去，命令改成：

pyinstaller --noconfirm --onefile --windowed --hidden-import tkinter --icon "C:/Andrea/Script/icon005.ico" --add-data "C:/Andrea/Script/icon005.ico;." "C:/Andrea/Script/script001.py"

说明：Windows系统下--add-data的分隔符是;，;.表示把图标文件放到程序运行时的根目录。

2. 修改Python代码适配路径

修改iconbitmap的调用逻辑，判断是打包后运行还是直接运行，动态获取图标路径：

import tkinter
import sys
import os

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)

if __name__ == '__main__':
    window = tkinter.Tk()
    # 动态获取图标路径
    icon_path = get_resource_path("icon005.ico")
    window.iconbitmap(icon_path)
    window.mainloop()  # 记得加mainloop，否则窗口会一闪而过

3. 额外注意点

• 确保icon005.ico是标准Windows ICO格式，16×16尺寸没问题，但建议同时包含32×32等多尺寸，避免兼容性问题。
• Windows下Tkinter对ICO格式支持更稳定，不建议用GIF作为窗口图标。

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