KivyMD/Python：如何实现头部下方标签面板？报错排查

错误原因分析 #

kivy.factory.FactoryException: Unknown class 通常由以下情况导致：

• kv文件中使用的组件类未在Python代码中导入
• 自定义组件未正确定义或注册
• kv文件命名不符合Kivy自动加载规则，或未手动加载kv文件

另外你当前用ScreenManager将Header和Tabs拆分为两个Screen的结构，不符合“头部下方展示Tab”的布局需求——正确结构应该是把MDTopAppBar和TabbedPanel放在同一个Screen的垂直布局中。

完整解决方案 #

1. 调整Python代码（main.py） #

确保导入所有需要的组件，构建正确的布局结构：

from kivy.app import App
from kivy.uix.screenmanager import ScreenManager, Screen
from kivy.uix.tabbedpanel import TabbedPanel, TabbedPanelItem
from kivy.uix.boxlayout import BoxLayout
from kivymd.app import MDApp
from kivymd.uix.topappbar import MDTopAppBar

class MainScreen(Screen):
    pass

class MyApp(MDApp):
    def build(self):
        sm = ScreenManager()
        sm.add_widget(MainScreen(name='main'))
        return sm

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

2. 编写对应的kv文件（main.kv） #

将MDTopAppBar和TabbedPanel放在同一个Screen的垂直BoxLayout中：

<MainScreen>:
    BoxLayout:
        orientation: 'vertical'
        
        MDTopAppBar:
            title: "头部标题"
            elevation: 4
        
        TabbedPanel:
            do_default_tab: False
            
            TabbedPanelItem:
                text: "标签1"
                Label:
                    text: "标签1的内容区域"
            
            TabbedPanelItem:
                text: "标签2"
                Label:
                    text: "标签2的内容区域"

3. 替代方案：使用KivyMD原生MDTabs（更适配MD风格） #

如果想贴合KivyMD的设计风格，推荐使用MDTabs组件，修改kv文件如下：

<MainScreen>:
    BoxLayout:
        orientation: 'vertical'
        
        MDTopAppBar:
            title: "头部标题"
            elevation: 4
        
        MDTabs:
            MDTabsItem:
                text: "标签1"
                Label:
                    text: "标签1的内容区域"
            
            MDTabsItem:
                text: "标签2"
                Label:
                    text: "标签2的内容区域"

同时在main.py中补充导入：

from kivymd.uix.tab import MDTabs, MDTabsItem

关键注意事项 #

• 不要将头部和Tab组件拆分到不同Screen，保持同一垂直布局内的层级关系
• 确保所有在kv中使用的组件类都已在Python代码中导入，避免FactoryException
• 若使用自定义组件，需先在Python中定义类，再在kv中引用

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