tkinter 的 iconbitmap 不支持 .ico 文件，应改用 iconphoto(true, photoimage(file="app.ico")) 设置主窗口图标；打包时需用 sys._meipass 动态定位图标路径。
iconbitmap 报错 _tkinter.TclError: bitmap "xxx.ico" not defined
这是最常见问题：Tkinter 的 iconbitmap 方法不接受 .ico 文件路径（尤其在 Windows 上），它实际只认 X11 位图格式（.xbm），而名字里带 “bitmap” 却硬要传图标文件，纯属历史包袱导致的误导。
实操建议：
- Windows 下想用 .ico，改用
iconphoto方法（推荐） - 如果坚持用
iconbitmap，必须先用工具把 .ico 转成 .xbm（极少用，不推荐） - Linux/macOS 下
iconbitmap也基本不可靠，统一走iconphoto
iconphoto(True, ...) 和 iconphoto(False, ...) 的区别
iconphoto 是 Tkinter 8.6+ 推荐的跨平台图标设置方式，第一个参数决定是否设为“默认窗口图标”——影响任务栏、Alt+Tab 切换、子窗口继承等行为。
实操建议：
- 设主窗口图标：用
root.iconphoto(True, photo)，True表示该图标将作为整个应用所有 Toplevel 窗口的默认图标 - 只设当前窗口图标（不继承）：用
root.iconphoto(False, photo)，但多数场景不需要 - 必须传
PhotoImage对象，不能传路径字符串
PhotoImage 加载 .ico 失败：_tkinter.TclError: couldn't recognize image data
Tkinter 自带的 PhotoImage 默认只支持 GIF、PPM/PGM；.ico 需要额外条件才能加载成功。
实操建议：
- Windows 上 Python 3.7+ 内置支持 .ico（只要 Tk 版本 ≥ 8.6），直接写
PhotoImage(file="app.ico")即可 - macOS/Linux 不支持 .ico，得转成 PNG + 用 Pillow 加载再转
PhotoImage - 路径必须是绝对路径或确保工作目录正确，相对路径容易加载失败
- 建议加异常捕获：
try:<br> img = PhotoImage(file="app.ico")<br> root.iconphoto(True, img)<br>except TclError:<br> pass # 降级处理
打包成 exe 后图标消失（PyInstaller / cx_Freeze）
打包工具不会自动把图标文件打进资源，iconphoto 加载的是运行时路径下的文件，而打包后图标不在预期位置。
实操建议：
- 用 PyInstaller 时，加
--add-data "app.ico;."（Windows）或--add-data "app.ico:."（macOS/Linux），让图标随 exe 一起解压 - 代码中用
sys._MEIPASS动态拼图标路径：import sys<br>if getattr(sys, 'frozen', False):<br> icon_path = os.path.join(sys._MEIPASS, "app.ico")<br>else:<br> icon_path = "app.ico"
- 别依赖当前工作目录 —— 打包后 cwd 很可能是系统临时目录
图标设置不是“设了就完事”，真正麻烦的是路径解析时机、打包后的资源定位、以及不同 Tk 版本对 .ico 的支持差异。最容易被忽略的是：没检查 sys._MEIPASS 是否存在就直接拼路径，结果打包后静默失败。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
