Kivy ScrollView运行仅显示黑屏问题求助

问题核心原因 #

黑屏由两个关键问题引发：

1. kv文件命名不匹配Kivy规则：Kivy会自动加载与App类名（去除末尾App）小写一致的kv文件，你的App类是the_labApp，对应kv文件名应为thelab.kv，原命名错误导致布局未被加载。
2. ScrollView无法识别可滚动内容：StackLayout默认size_hint_y: 1，高度被限制为父容器高度，ScrollView检测不到超出视口的内容，无滚动区域可显示。

修复步骤 #

1. 修正kv文件命名 #

将你的kv文件重命名为thelab.kv。

2. 更新kv文件内容 #

修改thelab.kv，为StackLayout添加尺寸计算规则，让ScrollView能正确识别可滚动区域：

scroll_view_example:

<scroll_view_example@ScrollView>:
    stack_layout_example:

<stack_layout_example>:
    size_hint_y: None
    height: self.minimum_height

3. 优化Python代码（可选但推荐） #

适配不同屏幕分辨率，并显式加载kv文件确保布局生效：

from kivy.uix.stacklayout import StackLayout
from kivy.uix.button import Button
from kivy.metrics import dp
from kivy.app import App
from kivy.lang import Builder


class stack_layout_example(StackLayout):
    def __init__(self, **kwargs):
        super().__init__(**kwargs)
        for i in range(0, 100):
            size = dp(100)
            button = Button(
                text=str(i+1),
                size_hint=(None, None),
                size=(size, size)
            )
            self.add_widget(button)

class the_labApp(App):
    def build(self):
        Builder.load_file('thelab.kv')
        return self.root

the_labApp().run()

关键说明 #

• size_hint_y: None取消StackLayout的高度比例限制，允许它根据子部件计算自身高度
• height: self.minimum_height让StackLayout高度等于所有子按钮的总高度，确保ScrollView能滚动显示全部内容
• 使用dp()代替固定像素值，保证按钮在不同屏幕上的显示大小一致

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