.NET MAUI 中自定义底部 TabBar 需围绕位置、背景、图标文字、居中逻辑、平台适配五点展开:一、设 Shell.TabBarPlacement="Bottom";二、用 Shell.BackgroundColor 等附加属性统一样式;三、通过 ItemTemplate 中 Grid 布局实现图标与文字居中;四、按 Windows、Android、iOS 差异微调渲染与资源;五、无需平台渲染器,配齐三层即可稳定运行。

在 .NET MAUI 中,Shell 的 TabBar 默认支持底部显示(尤其在 Android 和 Windows 上),但原生行为和样式控制需配合平台特性与 Shell 属性协同调整。自定义底部标签栏不是单纯改颜色,而是围绕位置、背景、图标文字、居中逻辑、平台适配这五个关键点展开。
一、确保 TabBar 显示在底部
基础配置必须显式设置 Shell.TabBarPlacement="Bottom",否则 Windows 和 macOS 可能默认顶部显示:
- 在
AppShell.xaml的根内直接设置:... - Windows 平台若仍显示异常,可在
Platforms/Windows/App.xaml.cs的OnLaunched中补一句强制刷新(非必需但稳妥):Microsoft.Maui.Handlers.ShellHandler.Mapper.ModifyMapping(nameof(Shell.TabBarPlacement), ...); - iOS 需注意安全区域,底部 TabBar 会自动避开 Home Indicator,无需额外偏移
二、统一控制颜色与字体大小
通过 Shell 的附加属性或资源字典批量设置,避免逐项写死:
- 背景色:
Shell.BackgroundColor控制整个 TabBar 区域(含未选中项背景) - 文字颜色:
Shell.UnselectedColor(未选中)、Shell.SelectedColor(选中) - 图标+文字尺寸:
Shell.TabBarItemIconSize和Shell.TabBarItemFontSize支持OnPlatform适配,例如:Value="{OnPlatform iOS=22, Android=28, Windows=24}" - 标题是否显示:
Shell.TabBarIsVisible="True"(默认 true,调试时可临时设 false 排查)
三、让图标和文字真正居中对齐
MAUI 默认图标居左、文字左对齐,要“图标居中 + 文字居中于图标下方”,需重写 Tab 的模板:
- 在
AppShell.xaml中为每个添加ItemTemplate: - 用
Grid布局包裹Image和Label,设置HorizontalOptions="Center"和VerticalOptions="Center" -
Label加上HorizontalTextAlignment="Center",并设Margin="0,4,0,0"控制图文间距 - 避免使用
StackLayout做外层容器——它无法保证等宽分布,动态增减 Tab 时易错位
四、平台差异化微调(重点在 Windows 和 Android)
Windows 上 TabBar 是 WinUI NavigationView 模拟的,Android 则基于 BottomNavigationView,两者渲染逻辑不同:
- Windows:背景色支持透明度(如
#CC2c3e50),但阴影需手动加Shadow或用Border包裹模拟 - Android:可通过自定义
TabBarHandler修改原生控件高度或禁用滑动切换动画;图标建议用.png且尺寸为 24×24(mdpi)或 48×48(xhdpi) - iOS:不支持纯色背景下的圆角裁剪,如需圆角需用
Frame包裹整个 TabBar 并设CornerRadius - 所有平台都建议图标资源放在
Resources/Images下,并启用MauiImage构建操作
基本上就这些。不需要写平台专属渲染器也能满足大多数场景,关键是把 TabBarPlacement、资源字典样式、ItemTemplate 这三层配齐,再按平台稍作验证即可稳定运行。










