Tkinter程序PyInstaller打包图片失败，如何将图片并入单exe？

1. 先检查resource_path的使用是否到位 #

你得确保程序里所有引用图片的地方，全换成resource_path("你的图片相对路径")。比如原来写的tk.PhotoImage(file="images/logo.png")，必须改成tk.PhotoImage(file=resource_path("images/logo.png"))。要是有漏改的地方，本地能跑（因为你电脑上有原图片文件），但其他电脑没这些文件，自然就报错找不到资源。

2. 给PyInstaller明确指定要打包的资源 #

光有resource_path还不够，你得告诉PyInstaller把这些图片一起打包进去，有两种简单方法：

方法一：命令行直接加参数 #

用--add-data参数（Windows用;分隔路径，macOS/Linux用:），假设你的图片都在./images文件夹里，打包命令这么写：

pyinstaller --onefile --add-data "images/*;images/" your_script.py

--onefile是生成单EXE的关键，--add-data的意思是：把本地images下的所有文件，打包后放到程序临时目录的images文件夹里，这样resource_path就能精准找到。

方法二：用.spec文件配置（适合资源多的情况） #

如果图片太多，命令行写起来麻烦，就生成.spec文件修改：

1. 先生成默认的spec文件：

pyinstaller --onefile your_script.py

2. 打开生成的your_script.spec，找到datas字段，改成下面这样：

datas=[('images/*', 'images')],

3. 最后用这个spec文件打包：

pyinstaller your_script.spec

3. 排查几个容易踩的坑 #

• 路径要完全匹配：打包时指定的路径（比如images/logo.png）和代码里resource_path里写的路径必须一致，不能混用绝对路径。
• 注意大小写：Windows不区分路径大小写，但macOS/Linux会，所以代码里的路径和实际文件名要一模一样。
• 临时测试路径：可以在程序里加两行打印，看看打包后的路径对不对：

print("Base path:", base_path)
print("Image path:", resource_path("images/logo.png"))

打包后运行EXE，控制台会输出临时目录的路径，你可以手动去那个目录看看有没有图片，就能知道是路径错了还是没打包进去。

4. 终极方案：把图片转成base64嵌入代码 #

要是上面的方法都不行，就把图片直接嵌进代码里，彻底告别外部资源：

1. 先把图片转成base64字符串，用这个小脚本：

import base64

with open("images/logo.png", "rb") as f:
    b64_data = base64.b64encode(f.read()).decode()
print(b64_data)

2. 把输出的长字符串复制到你的主程序里，定义成变量：

LOGO_B64 = "这里粘贴刚才的base64字符串"

3. 在Tkinter里用的时候，转成BytesIO对象就行：

import tkinter as tk
from io import BytesIO
import base64

logo_data = base64.b64decode(LOGO_B64)
logo_img = tk.PhotoImage(data=logo_data)

这种方式完全不需要外部文件，打包后肯定不会出现找不到资源的问题，适合图片数量不多的场景。

内容的提问来源于stack exchange，提问作者jshh99