如何将带资源依赖的Python应用打包为单文件供终端用户使用？

你遇到的问题是单文件打包模式下，资源路径逻辑和直接运行py脚本不一致导致的，按下面步骤修改就能实现单文件内置所有图片，不需要用户额外存放资源：

第一步：修改代码中的资源加载逻辑 #

单文件模式下PyInstaller运行时会把内置的资源解压到系统临时目录，直接写相对路径读不到文件，你需要先在代码开头加一个路径适配函数，兼容开发环境和打包后的运行环境：

import sys
import os
import tkinter as tk

def resource_path(relative_path):
    # 打包后程序会把临时资源路径存在sys._MEIPASS属性下
    if hasattr(sys, '_MEIPASS'):
        base_dir = sys._MEIPASS
    else:
        # 本地跑脚本时直接用当前文件所在目录
        base_dir = os.path.abspath(".")
    return os.path.join(base_dir, relative_path)

之后把代码里所有加载图片的位置，都用这个函数包裹路径，举个例子：

# 原来的写法，单文件打包后找不到图片
# logo_img = tk.PhotoImage(file="logo.png")

# 修改后的写法，两种环境都能正常加载
logo_img = tk.PhotoImage(file=resource_path("logo.png"))

所有用到图片、其他配置资源的地方都要做这个修改，不要遗漏。

第二步：执行打包命令，指定要内置的资源 #

你用的是Linux Mint系统，打包命令里资源分隔符用冒号，不要用Windows下的分号。打开终端进入你的脚本所在文件夹，执行下面的命令：

pyinstaller --onefile --windowed --add-data "*.png:." script.py

参数说明：

• --onefile：生成单个独立可执行文件，所有依赖和资源都打包在这一个文件里
• --windowed：GUI程序专用参数，运行时不会弹出黑色终端窗口
• --add-data "*.png:."：把当前目录下所有png格式图片打包进程序，存放在程序运行时的根目录，和你代码里写的相对路径匹配
  如果你还有jpg、gif等其他格式的资源，多写几个对应的--add-data参数就行，比如要打包jpg就加--add-data "*.jpg:."；如果资源存放在子文件夹（比如images文件夹），就对应写--add-data "images/*:images"，保证本地路径和打包后的路径结构一致即可。

验证结果 #

打包完成后，生成的单可执行文件在dist目录下，你可以把这个文件单独复制到任意位置双击运行，不需要额外复制图片文件，所有资源已经内置在程序里，可以直接分享给其他同系统的用户使用。

新手常见注意点：

• 改完代码先直接跑一遍py脚本，确认图片能正常加载再打包，避免代码本身写错
• 如果打包后还是提示找不到文件，先检查是不是所有资源加载的地方都用了resource_path函数，再检查--add-data参数的分隔符、路径是不是写对了

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