根本原因是PyInstaller默认不打包图片等资源文件，需用--add-data声明并配合resource_path函数动态定位：打包时pyinstaller --add-data "assets;assets" main.py，运行时通过sys._MEIPASS获取实际路径。
打包后 Tkinter PhotoImage 找不到图片文件
根本原因是：PyInstaller 默认只打包 Python 源码，.png、.jpg 这类资源文件不会自动包含进去。运行时 PhotoImage(file="icon.png") 就会抛 TclError: couldn't open "icon.png": no such file or directory。
常见错误现象是程序在开发环境能跑，双击 exe 却黑窗口闪退，或者图标/背景图直接空白——其实不是代码错，是路径没找对。
- 不要把图片和 .exe 放一起手动补救：用户不一定会解压、也不懂放哪
- 不要硬编码绝对路径（比如
C:/myapp/icon.png）：换电脑就失效 - 必须让程序在打包后能“自带”图片，并且知道怎么定位它
用 --add-data 把图片打进包里并动态定位
这是最通用、最可控的方式。关键是两步：打包时声明资源路径 + 运行时用 sys._MEIPASS 找到实际解压位置。
使用场景：图片较多、需保留原始格式（如透明 PNG）、或后续要换图不重编译。
Windows 下命令示例：pyinstaller --onefile --add-data "assets;assets" main.py
注意分号是分隔符（Linux/macOS 用冒号），assets 是你本地图片所在文件夹，也会作为运行时的子目录名。
- 代码里别再写
PhotoImage(file="assets/icon.png") - 改用函数封装路径逻辑：
import sys import os 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) img = PhotoImage(file=resource_path("assets/icon.png")) -
sys._MEIPASS只在打包后存在；开发时走os.path.abspath(".")，保持本地调试正常
小图直接 Base64 编码嵌进代码里
适合单张小图标（
性能影响几乎为零，兼容性最好——连 sys._MEIPASS 都不用判了。但别对 5MB 的背景图这么干，会拖慢启动、污染代码。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- 用在线工具或脚本把
icon.png转成 Base64 字符串（去掉换行和前缀data:image/png;base64,） - 代码里直接传字符串：
icon_b64 = "iVBORw0KGgoAAAANSUhEUgAA..." img = PhotoImage(data=icon_b64)
- 注意
PhotoImage的data参数只接受 Base64 字符串，不是二进制；别漏掉data=关键字
为什么不用 pkg_resources 或 importlib.resources
它们在 PyInstaller 打包后大概率失效——因为不是标准 zipimport 场景，__file__ 和模块路径全被重定向了，容易返回空或错路径。
实测中 importlib.resources.files("myapp").joinpath("icon.png") 在 --onefile 模式下常抛 FileNotFoundError，属于「理论上可行、实际上踩坑」的方案。
除非你用 --onedir 且严格控制资源结构，否则别碰。老老实实用 --add-data + sys._MEIPASS 最稳。
真正容易被忽略的是：路径拼接必须用 os.path.join() 或 pathlib.Path，别手写斜杠；Windows 用反斜杠、Linux 用正斜杠，混用会导致 resource_path("assets\icon.png") 在 Linux 上崩。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
