.NET Maui强制浅色主题后TextCell不显示且Entry样式异常

问题根源 #

直接在App.xaml.cs构造函数中设置Application.Current.UserAppTheme = AppTheme.Light;时机过早，会导致UI控件的主题资源未完成加载；另外部分控件默认绑定了系统主题样式，没有被强制浅色主题正确覆盖。

具体解决步骤 #

1. 调整主题设置时机 #

把主题设置代码移到OnStart方法中，并用Dispatcher延迟执行，确保UI资源初始化完成：

protected override void OnStart()
{
    Dispatcher.Dispatch(() =>
    {
        Application.Current.UserAppTheme = AppTheme.Light;
    });
}

2. 强制覆盖Entry控件样式 #

在App.xaml的ResourceDictionary中添加全局样式，直接指定Entry的浅色主题属性：

<Application.Resources>
    <ResourceDictionary>
        <!-- 其他已有资源 -->
        <Style TargetType="Entry">
            <Setter Property="BackgroundColor" Value="White" />
            <Setter Property="TextColor" Value="Black" />
            <Setter Property="PlaceholderColor" Value="Gray" />
        </Style>
    </ResourceDictionary>
</Application.Resources>

3. 修复TextCell不显示问题 #

TextCell大多是因为背景色与文字色一致导致不可见，可通过两种方式解决：

全局样式统一设置

<Style TargetType="TextCell">
    <Setter Property="TextColor" Value="Black" />
    <Setter Property="DetailColor" Value="#666666" />
    <Setter Property="BackgroundColor" Value="White" />
</Style>

单个控件直接指定属性

<TextCell Text="测试内容" Detail="测试详情"
          TextColor="Black" DetailColor="#666666"
          BackgroundColor="White" />

4. 彻底禁用深色主题（可选） #

如果完全不需要兼容深色主题，可以直接在App.xaml中只加载浅色主题资源字典，注释掉深色主题引用：

<Application.Resources>
    <ResourceDictionary>
        <ResourceDictionary.MergedDictionaries>
            <ResourceDictionary Source="Resources/Styles/LightTheme.xaml" />
            <!-- 移除或注释深色主题 -->
            <!-- <ResourceDictionary Source="Resources/Styles/DarkTheme.xaml" /> -->
        </ResourceDictionary.MergedDictionaries>
    </ResourceDictionary>
</Application.Resources>

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