在 KivyMD 2.0+ 中，直接设置 md_bg_color 无法生效，必须先将 theme_bg_color 设为 "Custom" 才能启用自定义背景色。
在 kivymd 2.0+ 中，直接设置 `md_bg_color` 无法生效，必须先将 `theme_bg_color` 设为 `"custom"` 才能启用自定义背景色。
KivyMD 的 `MDTopAppBar` 默认遵循主题配色系统，其背景色受全局主题控制。即使显式声明 `md_bg_color`，若未启用自定义模式，该属性将被忽略，导致始终显示默认白色（或当前主题的 primary 背景色）。解决方法非常明确：**必须前置声明 `theme_bg_color: "Custom"`**，以此告知组件脱离主题约束，允许手动接管背景样式。
以下是正确配置的完整示例（KV 字符串形式）：
MDTopAppBar:
theme_bg_color: "Custom" # ✅ 关键：启用自定义背景模式
md_bg_color: 0.2, 0.4, 0.8, 1 # ✅ 此时生效：RGBA 值（R=0.2, G=0.4, B=0.8, A=1）
MDTopAppBarLeadingButtonContainer:
MDActionTopAppBarButton:
icon: "menu"
MDTopAppBarTitle:
text: "Página Principal"
MDTopAppBarTrailingButtonContainer:
MDActionTopAppBarButton:
icon: "dots-vertical"
⚠️ 注意事项：
theme_bg_color必须写在md_bg_color之前（KV 解析顺序敏感），否则可能不生效；- 取值仅支持
"Primary"、"Surface"、"Custom"三种字符串，其他值将回退至默认行为；- 若使用
MDScreenManager等嵌套结构（如原问题中的布局），请确保MDTopAppBar直接位于其父容器内，避免因层级或尺寸计算异常导致渲染异常；- 颜色值必须为四元组 RGBA 格式（如
1, 0.5, 0.2, 1），不可省略 alpha 通道。
此外，在 Python 代码中动态修改时，同样需按顺序设置：
top_bar = self.root.ids.top_app_bar top_bar.theme_bg_color = "Custom" top_bar.md_bg_color = (0.2, 0.4, 0.8, 1) # 顺序不可颠倒
这一机制体现了 KivyMD 对 Material Design 主题系统的严格遵循——“自定义”不是覆盖，而是显式切换渲染策略。掌握 theme_bg_color 这一开关，是精准控制所有 ThemableBehavior 组件（如 MDCard、MDNavigationDrawer 等）外观的基础。
