Kivy程序未显示指定图片，仅呈现空白白色背景问题求助

1. 类名大小写不匹配 #

Python代码中定义的是BackGround（G大写），但kv文件里写的是<Background>（G小写），Kivy无法关联对应的布局规则，导致kv里的设置完全不生效。
修复：把kv里的<Background>改成<BackGround>，和Python类名保持一致。

2. 图片路径错误且语法不完整 #

kv里的source: r'C:\Users\khanb\Desktop\images'存在两个问题：

• 仅指定到文件夹，未明确具体图片文件名（比如bg.png），Kivy找不到目标文件
• 字符串末尾的单引号未闭合，属于语法错误
  修复：补充完整文件名并闭合引号，示例：

source: r'C:\Users\khanb\Desktop\images\background.png'

注意：确认该路径下确实存在对应图片，文件名和后缀必须完全正确

3. 缺失必要控件导入 #

Python代码仅导入了Image，但用到的BoxLayout、GridLayout、Button、App都未导入，运行会直接报错。
修复：在Python代码开头补充导入：

from kivy.uix.boxlayout import BoxLayout
from kivy.uix.gridlayout import GridLayout
from kivy.uix.button import Button
from kivy.app import App

4. 布局层级优化（可选，实现背景效果） #

当前BackGround是BoxLayout，默认垂直排列，Buttons和包含Image的BoxLayout会上下分开，无法实现图片作为背景的效果。若要让图片铺满窗口作为背景，建议改用FloatLayout：

修改后的Python代码 #

from kivy.uix.image import Image
from kivy.uix.boxlayout import BoxLayout
from kivy.uix.gridlayout import GridLayout
from kivy.uix.button import Button
from kivy.uix.floatlayout import FloatLayout
from kivy.app import App

class BackGround(FloatLayout):
    def __init__(self, **kwargs):
        super().__init__(**kwargs)

class Buttons(GridLayout):
    def __init__(self, **kwargs):
        super(Buttons, self).__init__(**kwargs)
        self.cols=1
        self.add_widget(Button(text='clear wanted level',size=(180,100),size_hint=(None,None)))

class MyApp(App):
    def build(self):
        return BackGround()

if __name__ == '__main__':
    MyApp().run()

修改后的kv代码 #

<BackGround>:
    # 背景图片铺满窗口
    Image:
        source: r'C:\Users\khanb\Desktop\images\background.png'
        allow_stretch: True
        keep_ratio: False
        size_hint: 1, 1
    # 按钮居中显示
    Buttons:
        size_hint: None, None
        size: 180, 100
        pos_hint: {'center_x': 0.5, 'center_y': 0.5}

5. 验证kv文件命名规则 #

确保kv文件名是myapp.kv（与App类名MyApp对应，小写且去掉App后缀），否则Kivy无法自动加载。若文件名不符合规则，可在MyApp类中手动指定：

class MyApp(App):
    def build(self):
        return BackGround()
    def on_start(self):
        from kivy.lang import Builder
        Builder.load_file('你的kv文件名.kv')  # 替换为实际文件名

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