Kivy中通过Python向GridLayout添加Widget报错，寻求解决方案

常见错误原因 #

• 错误引用id：直接使用self.fp访问布局，Kivy中所有通过id定义的控件都存储在ids字典中，正确方式是self.ids.fp
• 布局未加载完成就调用方法：比如在__init__方法中直接执行add_widget，此时kv布局还未解析完成，ids字典中不存在目标控件
• 未导入TextInput控件：Python代码中未导入kivy.uix.textinput.TextInput，会触发NameError
• GridLayout参数缺失：未设置cols/rows属性，可能导致添加的控件无法正常显示（虽不直接报错，但属于常见问题）

正确实现代码 #

Python代码（main.py） #

from kivy.app import App
from kivy.uix.boxlayout import BoxLayout
from kivy.uix.textinput import TextInput

class MainLayout(BoxLayout):
    def add_textinput(self):
        # 通过ids字典获取目标GridLayout
        target_grid = self.ids.fp
        # 添加TextInput控件
        target_grid.add_widget(TextInput(text="1103"))

class TestApp(App):
    def build(self):
        return MainLayout()

if __name__ == "__main__":
    TestApp().run()

KV布局文件（test.kv） #

注意：KV文件名需与App类名对应（TestApp对应test.kv）

<MainLayout>:
    orientation: "vertical"
    Button:
        text: "添加TextInput"
        on_press: root.add_textinput()
    GridLayout:
        id: fp
        cols: 1
        size_hint_y: None
        height: self.minimum_height  # 自适应内容高度

关键说明 #

1. id访问方式：必须通过self.ids.xxx获取KV中定义的控件，这是Kivy的规范
2. 触发时机：通过按钮点击事件调用添加逻辑，确保KV布局已完全加载，ids字典中存在目标控件
3. 控件导入：使用任何Kivy控件前都需在Python代码中导入对应模块
4. GridLayout配置：设置cols/rows以及自适应高度的参数，保证添加的控件正常显示

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