Kivy使用pyinstaller打包为exe后仅显示灰色画布问题求助

算力阿峰

2026-10-16

问题根因

灰色窗口是kv界面规则未被正常加载导致的，Kivy仅渲染了你设置的全局灰色背景，没有加载你定义的按钮、选择器等界面元素。

修复步骤

1. 修复kv文件加载逻辑

你有两种可选方案：

方案一（推荐，无需手动写加载代码）：将你的kv文件重命名为main.kv，放在主py文件同级目录。Kivy的App类会自动加载和类名（去掉App后缀后转小写）同名的kv文件，你的App类名为MainApp，会自动匹配main.kv，无需额外调用Builder接口。
方案二（手动加载）：如果需要自定义kv文件名，要先处理路径适配逻辑，避免开发环境和打包环境的路径差异导致加载失败：

import sys
import os
from kivy.lang import Builder

def resource_path(relative_path):
    try:
        # PyInstaller打包后的临时目录变量
        base_path = sys._MEIPASS
    except Exception:
        # 开发环境取当前工作目录
        base_path = os.path.abspath(".")
    return os.path.join(base_path, relative_path)

# 调用该方法加载kv文件
Builder.load_file(resource_path("你的kv文件名.kv"))

2. 修改PyInstaller打包配置，将kv文件打入包内

PyInstaller默认不会自动打包非py格式的资源文件，需要手动指定：

命令行打包时添加--add-data参数：
Windows环境命令示例：pyinstaller -F -w --add-data "main.kv;." 主py文件名.py
Mac/Linux环境命令示例：pyinstaller -F -w --add-data "main.kv:." 主py文件名.py
如果你用spec文件打包，直接修改spec文件的datas配置项：
```
datas=[
    ('main.kv', '.'), # 前面是本地kv路径，后面是打包后的存放路径
]
```
之后用pyinstaller 你的spec文件名.spec命令打包即可。