PyInstaller打包后Tk窗口图标不显示的根本原因是资源路径未适配：需自定义resource_path()函数区分开发与打包环境，配合--add-data参数将图标文件正确打入包内，并确保.ico文件含多尺寸、使用Base64嵌入或正确设置Tk实例创建时机。
因为 PyInstaller 默认不把 icon.ico 这类资源文件打进包里，root.iconbitmap("icon.ico") 在开发时能跑通，打包后就直接报 TclError: bitmap "icon.ico" not defined 或静默失效——根本原因不是代码错，而是路径断了。
resource_path() 函数必须自己写，不能硬写 sys._MEIPASS
打包后图标路径要从 sys._MEIPASS 下读，但这个变量只在 PyInstaller 运行时存在；开发时直接用 __file__ 才对。写死会导致开发环境崩溃。
- 用
os.path.dirname(__file__)作 fallback，别用os.getcwd()或os.path.abspath(".")，后者依赖当前工作目录，双击运行时可能指向桌面 - 函数里不要拼绝对路径，只返回拼好的完整路径字符串，调用时传相对路径即可，比如
resource_path("assets/icon.ico") - Windows 下分号前后路径都得是正斜杠或双反斜杠，避免
os.path.join()混用导致路径错乱
--add-data 参数必须和代码路径严格匹配
光有 resource_path() 没用，资源得先进包。PyInstaller 不会自动扫描你代码里写了什么路径，全靠人工配对。
- 如果代码里是
resource_path("icon.ico")，那命令就得写--add-data "icon.ico;."（注意分号后是英文句点） - 如果代码里是
resource_path("assets/icon.ico")，那命令就得写--add-data "assets;assets" - Linux/macOS 把分号换成冒号，比如
--add-data "assets:assets" - 路径大小写敏感，
Icon.ico和icon.ico在 macOS/Linux 上就是两个文件
图标文件本身容易踩坑
即使路径全对，图标也可能不显示——Windows Explorer 只认标准 ICO 格式，且要求含多个尺寸（16×16、32×32、48×48），单尺寸 PNG 或 BMP 会被忽略。
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
立即学习“Python免费学习笔记（深入）”；
- 别用在线转的“一键 ICO”，优先用
convertio.co或 GIMP 导出多尺寸嵌入式 ICO - 打包命令里的
-i app.ico只影响 EXE 文件本身的图标（右键→属性看到的那个），不影响窗口左上角图标 - Windows 会缓存图标，改完图标后删掉
%USERPROFILE%\AppData\Local\IconCache.db并重启资源管理器
更省事的办法：Base64 嵌入图标数据
绕过所有路径逻辑，适合 ≤ 4KB 的小图标。不用管 --add-data，也不用写 resource_path()，连临时文件都不用生成。
- 用在线工具把
icon.ico转成 Base64 字符串，去掉data:image/x-icon;base64,前缀 - 在代码里用
base64.b64decode()解码，写入临时文件再传给iconbitmap()，最后os.remove() - 务必用
with open(..., "wb") as f:写入，否则 Windows 下可能因文件未释放导致图标加载失败
最常被忽略的一点：Tk 实例（tk.Tk()）必须在图标文件已就绪之后才创建。如果先 root = tk.Tk() 再下载/解码图标，哪怕路径完全正确，窗口也会用默认图标启动一次，之后再调用 iconbitmap() 也补不回来。
