使用Builder.load_file触发BuilderException的问题求助

问题重现 #

• 不手动调用Builder.load_file('mycoolapp.kv')时，程序正常运行——因为Kivy会自动匹配与App类同名的小写kv文件并加载
• 手动添加该代码后，kv中自定义按钮<MyRoundedButton_push@Button>的canvas.before代码里使用self.back_color等属性时，触发BuilderException，报错IndexError: list index out of range

问题原因 #

手动调用Builder.load_file的时机错误：原代码中Builder.load_file放在MyGameScreen类定义之后，此时Kivy解析kv文件时，自定义按钮的back_color等属性还未完成初始化，导致Color指令的rgb参数无法正确获取有效值，从而抛出索引越界错误。而Kivy自动加载kv的时机是在App启动阶段，此时所有相关类都已定义完成，属性初始化顺序更合理，所以不会出错。

解决方案 #

1. 调整Builder.load_file的调用时机

把Builder.load_file('mycoolapp.kv')移到所有自定义类定义之前，确保Kivy解析kv时能正确识别类结构和属性。修改后的Python代码如下：

import kivy
from kivy.app import App
from kivy.uix.boxlayout import BoxLayout
from kivy.uix.screenmanager import ScreenManager, Screen
from kivy.lang import Builder

kivy.require('1.9.0')

# 提前加载kv文件，确保解析时所有类已定义
Builder.load_file('mycoolapp.kv')

class MyGameScreen(BoxLayout):
    
    def __init__(self):
        super(MyGameScreen, self).__init__()
        self.i = 0
        
    def btn_push_press(self):
        if self.i == 0:
            self.btn_push.back_color = (0, 0, 1, 1)
            self.btn_push.pressed_color = (1, 0, 0, 1)
            self.i = 1
        elif self.i == 1:
            self.btn_push.back_color = (0, 1, 1, 1)
            self.btn_push.pressed_color = (1, 0, 1, 1)
            self.i = 0

class MyCoolApp(App):
    def build(self):
        return MyGameScreen()

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

2. 增强kv代码的稳定性（可选）

给Color指令的rgb参数添加默认值，避免属性未初始化时出错：

<MyGameScreen>:  
    btn_push: btn_push
    
    BoxLayout:
        id: game_screen
        orientation: 'vertical'
        
        MyRoundedButton_push:
            id: btn_push
            text: "PUSH"
            font_size: 48
            color: [1,1,1,1]
            on_press: root.btn_push_press()

                
<MyRoundedButton_push@Button>:
    background_normal: ''
    background_color: (0, 0, 0, 0)
    back_color: (0, 1, 1, 1)
    pressed_color: (1, 0, 1, 1)
    border_radius: [100]
    canvas.before:
        Color:
            rgb: self.back_color if self.state == 'normal' else self.pressed_color or (1,1,1,1)
        RoundedRectangle:
            size: self.size
            pos: self.pos
            radius: self.border_radius

3. 多屏幕场景适配（针对你提到的ScreenManager需求）

如果要实现多屏幕，确保ScreenManager和Screen的定义在kv加载前完成，或者直接在kv中定义ScreenManager结构：

• 在kv文件中添加：

<MyScreenManager>:
    MyGameScreen:
        name: 'game'

• 在Python代码中添加MyScreenManager类：

class MyScreenManager(ScreenManager):
    pass

• 修改App的build方法：

class MyCoolApp(App):
    def build(self):
        return MyScreenManager()

内容的提问来源于stack exchange，提问作者Andrey Loshakov