PyInstaller打包运行main.exe提示找不到路径内已存在的png图片如何解决

这是PyInstaller打包程序的典型路径解析问题，和本地文件是否实际存放到位没有直接关系：

• 单文件模式打包的exe运行时，会自动将内置资源解压到系统临时目录下随机命名的_MEIxxxxxx文件夹，程序启动时的默认工作目录为该临时目录，并非你存放源码或exe的Python/Program Folder路径
• 如果选择将图片放在exe外部不打包进程序，只要启动exe时的工作目录和exe所在目录不一致（比如通过其他路径的脚本调用、快捷方式设置了非exe所在目录的起始位置），代码里写死的相对路径就会匹配失败
  你之前判断的“PyInstaller查找路径正确”是基于开发环境的路径逻辑，没有适配打包后的运行环境路径规则，因此会出现文件实际存在但程序无法识别的报错。

根据你是否要把图片打包进exe内部，二选一执行即可：

方案1：将图片打包进exe内部（单文件分发推荐） #

• 第一步：在代码中添加路径适配函数，自动识别开发环境/打包后环境的基准路径，不要直接写死相对路径

import sys
import os

def get_resource_path(relative_path):
    # 匹配PyInstaller打包后的临时解压路径
    if hasattr(sys, '_MEIPASS'):
        base_path = sys._MEIPASS
    else:
        # 开发环境下以脚本所在目录为基准
        base_path = os.path.abspath(".")
    return os.path.join(base_path, relative_path)

• 第二步：替换代码中所有引用图片的路径，将原有的"Python/Program Folder/image.png"替换为get_resource_path("Python/Program Folder/image.png")
• 第三步：打包时显式将图片加入打包资源列表
  命令行打包时添加--add-data参数，注意：Windows系统下路径分隔用分号;，Linux/macOS用冒号:，路径带空格必须加引号：

  pyinstaller --onefile --add-data "Python/Program Folder/image.png;Python/Program Folder" main.py
  

  如果使用spec文件配置打包，找到datas字段添加资源配置：

  datas=[('Python/Program Folder/image.png', 'Python/Program Folder')],
  

  配置完成后重新执行打包即可。

方案2：图片放在exe外部同目录（方便后续替换资源推荐） #

• 第一步：修改路径适配函数的基准路径为exe自身所在目录，替换原有路径逻辑：

import sys
import os

def get_resource_path(relative_path):
    # 以exe所在目录为统一基准路径，不受启动时工作目录影响
    if getattr(sys, 'frozen', False):
        base_path = os.path.dirname(os.path.abspath(sys.argv[0]))
    else:
        base_path = os.path.abspath(".")
    return os.path.join(base_path, relative_path)

• 第二步：同样将代码中所有图片引用路径替换为get_resource_path("Python/Program Folder/image.png")
• 第三步：正常打包exe，打包完成后将Python/Program Folder/image.png按照路径层级放在和main.exe同层级的位置即可，无论从什么路径启动exe都可以正常识别图片。

打包完成后不要在IDE内直接运行脚本验证，直接双击exe，或切换到其他目录用命令行调用exe，确认不再抛出文件找不到的报错即可。

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