如何编译包含.kv文件及资源文件的Python Kivy应用？

我之前折腾Kivy+PyInstaller打包的时候，在Windows7上踩过不少坑，尤其是单文件模式下资源找不到导致崩溃的问题，太懂这种头疼的感觉了！下面给你一步步拆解解决办法：

当你用--onefile参数时，PyInstaller会把所有依赖的Python代码、库、资源文件都打包进一个exe文件。运行这个exe的时候，它会自动把所有内容解压到系统的临时目录（比如C:\Users\你的用户名\AppData\Local\Temp\_MEIxxxxxx），然后在临时目录里执行程序。

这就意味着你代码里写的相对路径（比如./images/logo.png）在打包后会失效——因为运行时的工作目录不是exe所在的文件夹，而是那个临时目录。这就是大部分崩溃的根源。

要解决这个问题，需要做两件事：告诉PyInstaller把资源文件打包进去，在代码里动态获取打包后的资源路径。

1. 用spec文件管理打包配置（比命令行靠谱多了） #

命令行参数太零散，推荐用spec文件来配置。首先生成初始的spec文件：

PyInstaller.exe --onefile main.py

执行完后，你会得到一个main.spec文件，接下来我们要修改这个文件来添加资源。

打开main.spec，找到Analysis部分的datas参数，把你的所有资源都加进去：

a = Analysis(
    ['main.py'],
    # 重点：添加资源文件，格式是(源路径, 打包后的目标路径)
    datas=[
        ('main.kv', '.'),  # 把main.kv打包后放在临时目录的根目录
        ('images/*.png', 'images'),  # 把images文件夹下的所有png打包到临时目录的images子文件夹
        ('texts/*.txt', 'texts')     # 文本资源同理，保持目录结构
    ],
    # 别忘了添加Kivy的隐藏依赖，PyInstaller可能自动识别不全
    hiddenimports=['kivy.deps.sdl2', 'kivy.deps.glew', 'kivy.deps.gstreamer'],
    # 其他默认配置不用动...
)

2. 修改代码，动态获取资源路径 #

在main.py里添加一个工具函数，用来判断当前是开发环境还是打包后的exe环境，返回正确的资源路径：

import os
import sys

def get_resource_path(relative_path):
    """获取资源文件的绝对路径"""
    # sys._MEIPASS是PyInstaller打包后自动设置的临时目录路径
    if hasattr(sys, '_MEIPASS'):
        return os.path.join(sys._MEIPASS, relative_path)
    # 开发环境下，返回当前目录的相对路径
    return os.path.join(os.path.abspath('.'), relative_path)

然后把所有加载资源的代码都改成用这个函数：

• 加载main.kv：

from kivy.lang import Builder
# 不要直接写main.kv，用工具函数获取路径
Builder.load_file(get_resource_path('main.kv'))

• 加载图片：

from kivy.uix.image import Image
img = Image(source=get_resource_path('images/logo.png'))

• 加载文本文件：

with open(get_resource_path('texts/help.txt'), 'r', encoding='utf-8') as f:
    content = f.read()

3. 用修改后的spec文件重新打包 #

现在用spec文件来打包，而不是直接用main.py：

PyInstaller.exe main.spec

• 版本兼容性：Win7对新版本的Python、PyInstaller、Kivy支持不好，建议用这些版本：Python 3.7/3.8，PyInstaller 4.5.1，Kivy 2.0.0，亲测在Win7上能正常打包运行。
• 查看错误日志：如果exe还是崩溃，别直接双击运行，打开命令提示符，切换到exe所在目录，输入exe文件名运行，这样能看到具体的错误提示（比如“找不到某个资源文件”），方便定位问题。
• 权限问题：Win7下可能需要以管理员身份运行打包命令，或者把生成的exe放在非系统盘（比如D盘），避免权限不足导致解压失败。

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