root.iconbitmap()在Windows上常报错因路径非绝对、图标非纯.ico格式或含中文，macOS/Linux不支持该方法，应统一用root.iconphoto(True, PhotoImage(file="icon.png"))跨平台设置，打包时需用--add-data显式包含图标文件。
为什么 root.iconbitmap() 在 Windows 上常报错
直接调用 root.iconbitmap("icon.ico") 报 TclError: bitmap "icon.ico" not defined，通常是因为路径错误或格式不兼容。Tkinter 的 iconbitmap() 只接受 Windows 原生 .ico 文件，且路径必须是绝对路径（相对路径在打包或工作目录切换后极易失效）。更隐蔽的问题是：如果图标文件包含多个尺寸但 Tkinter 无法解析（比如含 PNG 图层的现代 ICO），也会静默失败。
- 确保图标是纯 Windows 格式 ICO（可用 icoconvert.com 转换，勾选 “Windows ICO”）
- 用
os.path.abspath()构造绝对路径，避免依赖当前工作目录 - 不要用 Unicode 路径名（如含中文）——即使路径存在，Tkinter 也可能拒绝加载
macOS 和 Linux 下不能用 iconbitmap()
macOS 完全忽略 iconbitmap()，Linux（X11）虽支持但行为不稳定。跨平台方案必须绕过它。正确做法是使用 root.iconphoto()，它接受 PhotoImage 对象，支持 PNG、GIF、PPM 等格式，且三端一致生效。
-
root.iconphoto(True, photo)中的True表示设为窗口及所有子窗口默认图标 - 必须在
root.mainloop()之前调用，否则无效 - PNG 图标推荐尺寸为 128×128 或 256×256（macOS 对高分屏敏感）
- Linux 下若仍不显示，检查桌面环境是否禁用客户端图标（如某些 KDE 设置）
一个能跑通的跨平台代码片段
下面这段代码同时适配 Windows（.ico）、macOS/Linux（.png），并自动 fallback：
import tkinter as tk
from tkinter import PhotoImage
import os
<p>root = tk.Tk()
root.title("My App")</p><h1>尝试加载 PNG（macOS/Linux 优先）</h1><p>icon_path = os.path.join(os.path.dirname(<strong>file</strong>), "icon.png")
try:
icon = PhotoImage(file=icon_path)
root.iconphoto(True, icon)
except tk.TclError:</p><h1>fallback 到 Windows ICO</h1><pre class="brush:php;toolbar:false;">ico_path = os.path.join(os.path.dirname(__file__), "icon.ico")
if os.path.exists(ico_path):
root.iconbitmap(ico_path)
立即学习“Python免费学习笔记（深入）”；
注意：PhotoImage 对象必须保持引用（不能被 GC 回收），上面写法中 icon 是局部变量，但在 root.iconphoto() 内部已被 Tk 持有引用，所以安全；若你把它赋给某个 widget 属性，也要确保该 widget 存活。
PyInstaller 打包后图标丢失怎么办
打包时图标文件不会自动包含进 exe，必须显式添加。命令行加 --add-data "icon.png;."（Windows）或 --add-data "icon.png:."（macOS/Linux），并在代码中用 sys._MEIPASS 读取运行时路径：
import sys
import os
<p>def resource_path(relative_path):
if getattr(sys, 'frozen', False):
base_path = sys._MEIPASS
else:
base_path = os.path.abspath(".")
return os.path.join(base_path, relative_path)</p><p>icon = PhotoImage(file=resource_path("icon.png"))
root.iconphoto(True, icon)
最易被忽略的是：很多人只处理了 PNG 路径，却忘了在 PyInstaller 命令里也把 .ico 文件加进去 —— 如果你的代码有双格式 fallback，两个文件都得打包。
