Kivy启动屏与底部导航设置教程

本文深入解析了KivyMD应用中默认启动屏幕设置与底部导航栏图标的精细化控制，直击“启动显示错误页面”这一常见痛点，明确指出默认屏幕由ScreenManager首个注册屏幕的name与对应MDBottomNavigationItem的name严格匹配决定，并强调ScreenManager必须作为build()方法的直接返回值；同时提供两种实用方案实现图标隐藏、纯文本菜单定制，辅以关键注意事项和可立即复用的代码片段，助你快速构建启动精准、界面灵活、维护性强的现代化移动UI。

本文详解如何在 KivyMD 应用中指定启动时默认显示的屏幕（如 HomeScreen），并灵活控制底部导航栏（MDBottomNavigation）中图标的显隐，实现纯文本菜单或图标+文字混合布局。

在 KivyMD 的 MDBottomNavigation 架构中，应用启动时默认显示哪个屏幕，并不由 .kv 文件中 MDBottomNavigationItem 的书写顺序决定，而是由 ScreenManager 实例中首个添加的屏幕（即 sm.add_widget(...) 的第一个调用）所对应的 name 值，与当前激活的 MDBottomNavigationItem.name 是否匹配来共同决定。若不匹配，则可能显示空白或异常行为——这正是原问题中“程序启动显示 shop 而非 main”的根本原因。

✅ 正确设置默认启动屏幕

关键在于两点：

1. 确保 ScreenManager 中首个注册的屏幕 name 与底部导航中对应项的 name 完全一致；
2. ScreenManager 必须作为根控件返回（而非 WindowManager），否则导航逻辑无法正确绑定。

以下是修正后的 main.py 核心部分：

from kivymd.app import MDApp
from kivy.lang import Builder
from kivy.uix.screenmanager import ScreenManager, Screen
from kivy.core.window import Window
from kivy.utils import get_color_from_hex
from kivy.core.text import LabelBase

Window.size = (430, 930)

class ShopScreen(Screen):
    pass

class ItemsScreen(Screen):
    pass

class HomeScreen(Screen):
    # 注意：KV 文件应在 build() 中统一加载，此处无需重复 load_file
    pass

class MainApp(MDApp):
    def build(self):
        self.theme_cls.theme_style = "Dark"

        # ✅ 正确创建并配置 ScreenManager
        sm = ScreenManager()
        sm.add_widget(HomeScreen(name='main'))     # ← 首个添加 → 启动默认屏
        sm.add_widget(ItemsScreen(name='items'))
        sm.add_widget(ShopScreen(name='menu'))     # 注意：此处 name='menu'，需与 .kv 中保持一致

        # ✅ 直接返回 ScreenManager（非 WindowManager）
        Builder.load_file("main.kv")
        return sm

if __name__ == "__main__":
    LabelBase.register(
        name="Press Start 2P",
        fn_regular='./font/PressStart2P-Regular.ttf'
    )
    MainApp().run()

同时，务必同步更新 main.kv 中 MDBottomNavigationItem 的 name 属性，使其与 Python 中注册的 name 严格一致：

:
    font_name: "./font/PressStart2P-Regular.ttf"
    panel_color: get_color_from_hex("#1B1B1B")
    text_color_active: 1, 1, 0, 1

    MDBottomNavigationItem:
        icon: 'store'              # 推荐使用语义化图标，如 'store' 代替 'home'
        name: 'menu'               # ✅ 必须与 ShopScreen(name='menu') 一致
        text: 'МАГАЗИН'
        ShopScreen:                # 内嵌对应屏幕

    MDBottomNavigationItem:
        icon: 'home'
        name: 'main'               # ✅ 必须与 HomeScreen(name='main') 一致
        text: 'ГОЛОВНА'
        HomeScreen:

    MDBottomNavigationItem:
        icon: 'help-circle'
        name: 'items'
        text: 'ХЕЛПЕРИ'
        ItemsScreen:

⚠️ 重要注意事项：

• ScreenManager 必须是 build() 方法的最终返回值，否则 MDBottomNavigation 将无法感知屏幕切换逻辑；
• 所有 Screen 子类（如 HomeScreen）不应在类定义体内调用 Builder.load_file()，应统一在 build() 中加载，避免重复解析与命名冲突；
• 图标名建议使用 Material Design Icons 标准名称（如 'store', 'help-circle'），提升可维护性。

? 自定义底部导航：隐藏图标仅保留文字

MDBottomNavigationItem 默认同时显示图标和文字。若需纯文本菜单（即隐藏图标），可通过以下两种方式实现：

方式一：CSS 风格隐藏（推荐，简洁可靠）

在 main.kv 中为每个 MDBottomNavigationItem 添加样式规则：

MDBottomNavigationItem:
    icon: 'store'
    name: 'menu'
    text: 'МАГАЗИН'
    # 隐藏图标，仅保留文字
    IconLeftWidget:
        icon: ''  # 清空图标
        size_hint_x: None
        width: 0
    ShopScreen:

# 其他项同理...

方式二：重写 MDBottomNavigationItem 的 on_enter 行为（进阶）

若需动态控制（如根据主题切换显隐），可在 Python 中继承并覆盖 _update_icon 方法，但日常开发中方式一已完全满足需求。

? 总结

• 启动默认屏幕 = ScreenManager 中首个 add_widget() 的 name + 对应 MDBottomNavigationItem.name 匹配；
• 根控件必须是 ScreenManager 实例，不可包装在 FloatLayout 或自定义容器中（除非你手动桥接导航事件）；
• 图标显隐通过 KV 层样式控制最安全高效，避免修改底层组件逻辑；
• 所有资源路径（字体、KV 文件）请确保相对位置正确，调试时可启用 kivy.logger 查看加载日志。

遵循以上结构，你的 KivyMD 应用即可稳定启动至 HomeScreen，并支持灵活的底部菜单视觉定制。

到这里，我们也就讲完了《Kivy启动屏与底部导航设置教程》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！