使用PyInstaller将.py转.exe时图片和图标无法加载如何解决？

核心原因说明 #

你遇到的问题可以完全解决，根本原因是PyInstaller的--onefile模式运行时，会先把所有打包内容解压到系统临时文件夹（对应运行时环境变量sys._MEIPASS），但你代码里的资源路径默认读取的是exe所在的工作目录，两者不匹配就会触发资源加载失败。
你看到的Failed to obtain/convert traceback!报错是资源加载异常后，PyInstaller窗口模式无法正常打印回溯信息的附带提示，修复路径问题后会自动消失。

步骤1：修改代码的资源读取逻辑 #

在你的Python脚本中新增路径适配函数，统一处理开发环境和打包后环境的路径读取：

import os
import sys

def resource_path(relative_path):
    """适配双环境的资源路径获取函数"""
    try:
        # 打包后运行时读取PyInstaller生成的临时目录路径
        base_path = sys._MEIPASS
    except AttributeError:
        # 开发环境下读取当前脚本所在目录路径
        base_path = os.path.abspath(".")
    return os.path.join(base_path, relative_path)

所有加载资源的位置都要调用这个函数处理路径，比如：

# 加载png图片
png_path = resource_path("你的图片名.png")
# 加载程序图标
icon_path = resource_path("你的图标名.ico")

步骤2：打包时指定需要嵌入的资源 #

方式1：直接通过打包命令传参（资源少的场景优先用） #

Windows环境下执行以下打包命令即可：
pyinstaller --onefile --windowed --icon=你的图标名.ico --add-data "你的图片名.png;." --add-data "你的图标名.ico;." 你的脚本名.py

注：;.是Windows专属写法，含义是把指定资源打包到运行时的根目录，和你代码里写的相对路径匹配；如果是Mac/Linux环境，把;.替换为:.即可。

方式2：通过spec配置文件打包（资源多的场景优先用） #

1. 先执行pyi-makespec 你的脚本名.py生成同名spec配置文件
2. 打开spec文件，找到datas配置项，修改为：
   datas=[("你的图片名.png", "."), ("你的图标名.ico", ".")],
3. 用spec文件执行打包：
   pyinstaller --onefile --windowed 你的脚本名.spec

验证效果 #

打包完成后直接运行dist目录下的exe文件，不需要额外放置资源文件即可正常加载所有图片、图标。

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