根本原因是PyInstaller默认不打包.png等非Python文件，需用--add-data参数将资源加入包内，并通过resource_path()函数动态获取sys._MEIPASS路径或开发路径，确保PhotoImage能正确定位文件。
为什么打包后 PhotoImage(file="xxx.png") 报错 TclError
根本原因不是代码写错了，而是 PyInstaller 默认不打包 .png、.ico 这类非 Python 文件。运行时 PhotoImage 去当前工作目录找文件，但实际资源压根没进去——临时解压目录里只有代码和库，图片是空的。典型报错就是：TclError: couldn't open "icon.png": no such file or directory。开发环境能跑，双击 exe 就白屏或闪退，基本可以锁定是这个路径问题。
必须用 sys._MEIPASS 动态定位资源，但不能硬写
sys._MEIPASS 是 PyInstaller 在打包后自动注入的变量，指向它解压资源的真实路径（比如 C:\Users\XXX\AppData\Local\Temp\_MEI12345\）。但它只在打包后存在，开发时直接访问会抛 AttributeError。所以不能这么写：
img = PhotoImage(file=os.path.join(sys._MEIPASS, "assets/icon.png")) # ❌ 开发时就崩
正确做法是封装一个兼容函数，自动判断环境：
- 打包后走
sys._MEIPASS - 开发时回退到
os.path.dirname(__file__)或Path(__file__).parent - 统一返回绝对路径字符串，供
PhotoImage(file=...)或open(...)直接用
--add-data 参数必须配对使用，否则 sys._MEIPASS 也找不到
光写函数没用，资源文件得先进包里。用 --add-data 告诉 PyInstaller “把谁放哪”：
立即学习“Python免费学习笔记（深入）”；
- Windows：命令里用分号分隔，例如
--add-data "assets;assets"表示把本地assets/文件夹整个打进包，并在解压后保持为assets/子目录 - Linux/macOS：分号换成冒号，即
--add-data "assets:assets" - 单个文件也要写全路径，比如
--add-data "config.json;."表示把config.json放进解压根目录 - 目标路径写
.表示根目录，写assets表示子目录——函数里拼路径时必须严格匹配这个结构
如果打包命令漏了 --add-data，或者目标路径写错（比如写成 res 但代码里还拼 "assets/icon.png"），sys._MEIPASS 下依然没有对应文件，照样报错。
小图标建议直接 Base64 编码，绕过路径逻辑
对于 .ico 或小尺寸 .png（建议 ≤ 4KB），Base64 嵌入最省事：
- 用在线工具转图成 Base64 字符串，去掉
data:image/png;base64,前缀 - 代码里直接传给
PhotoImage(data=...)，不用管路径、不用--add-data、也不用判sys._MEIPASS - 示例：
img = PhotoImage(data="iVBORw0KGgoAAAANSUhEUgAA...") - 缺点明显：大图会导致启动变慢、代码臃肿；无法热更新；不适用于需要用户自定义图标的场景
真正容易被忽略的是：很多开发者写了 resource_path() 函数，却忘了在打包命令里加 --add-data，或者目标路径和函数里拼的不一致——这时候函数返回的路径是对的，但那个路径下根本没文件，错误还是照常发生。
