Kivy中Screen界面GUI空白不显示问题排查与修复方案

你遇到的空窗口问题，以及注释build方法后程序反而能运行的现象，本质是Kivy的kv规则加载机制和你手动提前实例化UI控件的写法冲突：

• Kivy加载kv规则的时机是App启动后、build方法执行前。kv里写的控件样式、子控件结构，只会自动应用到kv加载完成后新创建的控件实例上。
• 你在Python全局作用域提前写了sm = WindowManager()，还手动创建了LoginScreen、HomeScreen实例添加到sm里。这些控件实例创建的时候，kv规则还没加载完成，所以kv里定义的输入框、按钮、标签等子控件根本没有被绑定到这些提前创建的Screen实例上，最后build返回这个提前构造的sm时，自然只有空窗口。
• 当你注释掉build方法的return逻辑后，Kivy会走默认逻辑：自动加载匹配类名的kv文件，按照kv里的规则从头创建所有控件实例，这时候所有控件都是kv加载完成后生成的，规则能正常生效，所以界面能显示，但这种写法你没有正确持有ScreenManager的引用，后续屏幕切换很容易出空指针错误。
• 额外还有两个隐藏bug：一是你的kv文件里<LoginScreen>行开头有多余缩进，不符合kv语法要求；二是你给Screen设置的name是login/home，切换屏幕时传的却是LoginScreen/HomeScreen，就算界面加载出来切换也会报错。

Python文件（命名随意，比如main.py） #

from kivy.app import App
from kivy.config import Config
Config.set('graphics', 'width', '400')
Config.set('graphics', 'height', '600')
from kivy.uix.screenmanager import ScreenManager, Screen
from kivy.properties import ObjectProperty

class HomeScreen(Screen):
    def returnBtn(self):
        # 直接通过Screen自带的manager属性获取当前屏幕管理器，不需要全局变量
        self.manager.current = 'login'

class LoginScreen(Screen):
    email = ObjectProperty(None)
    password = ObjectProperty(None)
    login_lst = []

    def on_kv_post(self, base_widget):
        # kv加载完成后再读取密码文件，避免启动时路径异常
        self.passwordStudents = open('passwords/passwordStudents.txt').read()
        self.passwordTeachers = open('passwords/passwordTeachers.txt').read()
        self.passwordAdmin = open('passwords/passwordAdmin.txt').read()

    def loginBtn(self):
        self.login_lst.append(self.email.text)
        self.login_lst.append(self.password.text)
        if self.login_lst[0] and self.login_lst[-1] in self.passwordStudents:
            print('Student: True')
            print('Teacher: False')
            print('Admin: False')
            self.reset()
            self.home()
        elif self.login_lst[0] and self.login_lst[-1] in self.passwordTeachers:
            print('Student: False')
            print('Teacher: True')
            print('Admin: False')
            self.reset()
            self.home()
        elif self.login_lst[0] and self.login_lst[-1] in self.passwordAdmin:
            print('Student: False')
            print('Teacher: False')
            print('Admin: True')
            self.home()
            self.reset()
        else:
            print('Student: False')
            print('Teacher: False')
            print('Admin: False')
            self.reset()

    def reset(self):
        self.email.text = ''
        self.password.text = ''
        self.login_lst.clear()

    def home(self):
        self.manager.current = 'home'

class WindowManager(ScreenManager):
    pass

class MyApp(App):
    # 不需要重写build方法，Kivy会自动加载同目录下的my.kv作为根控件
    pass

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

kv文件（必须命名为my.kv，和main.py放在同一目录） #

注意：kv文件对缩进要求严格，所有类规则、根规则必须顶格写，不要有前置空格，子控件逐层缩进。

<LoginScreen>:
    name: "login"
    email: email
    password: psswrd
    BoxLayout:
        orientation: "vertical"
        padding: 20
        spacing: 20
        Label:
            text: "Login"
            font_size: 50
            size_hint_y: 0.3
        GridLayout:
            cols: 2
            spacing: 10
            Label:
                size_hint_x: 0.4
                text: "Email:"
                font_size: 20
            TextInput:
                id: email
                multiline: False
                font_size: 20
        GridLayout:
            cols: 2
            spacing: 10
            Label:
                size_hint_x: 0.4
                text: "Password:"
                font_size: 20
            TextInput:
                id: psswrd
                multiline: False
                password: True
                font_size: 20
        FloatLayout:
            size_hint_y: 0.3
            Button:
                size_hint: None, None
                width: "150dp"
                height: "60dp"
                pos_hint: {'center_x':0.5, 'center_y':0.5}
                text: "Submit"
                font_size: 25
                on_release:
                    root.loginBtn()

<HomeScreen>:
    name: "home"
    BoxLayout:
        padding: 50
        Button:
            text: "Go back"
            font_size: 30
            on_release:
                root.returnBtn()

# 根规则：直接创建ScreenManager实例，自动添加两个屏幕
WindowManager:
    LoginScreen:
    HomeScreen:

• 不要在Python全局作用域提前实例化任何UI控件，所有控件实例要么在kv中声明，要么在类的初始化方法、on_kv_post、build方法内创建，避免kv规则未加载就生成实例导致的渲染异常。
• kv文件缩进必须严格统一，不要混用空格和Tab，根规则、类规则必须顶格书写。
• Screen的name属性要和切换屏幕时传入的current参数完全一致，不要混淆类名和name属性。
• 不需要用全局变量持有ScreenManager引用，每个Screen实例自带manager属性，可直接获取所属的屏幕管理器实例，避免生命周期异常。

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