本文详解如何在 kivymd 应用中指定启动时默认显示的屏幕（如 homescreen），并灵活控制底部导航栏（mdbottomnavigation）中图标的显隐，实现纯文本菜单或图标+文字混合布局。
在 KivyMD 的 MDBottomNavigation 架构中，应用启动时默认显示哪个屏幕，并不由 .kv 文件中 MDBottomNavigationItem 的书写顺序决定，而是由 ScreenManager 实例中首个添加的屏幕（即 sm.add_widget(...) 的第一个调用）所对应的 name 值，与当前激活的 MDBottomNavigationItem.name 是否匹配来共同决定。若不匹配，则可能显示空白或异常行为——这正是原问题中“程序启动显示 shop 而非 main”的根本原因。
✅ 正确设置默认启动屏幕
关键在于两点：
- 确保 ScreenManager 中首个注册的屏幕 name 与底部导航中对应项的 name 完全一致；
- 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，并支持灵活的底部菜单视觉定制。
