从Xamarin.Forms迁移至.NET MAUI后样式与颜色失效问题

针对你迁移Xamarin.Forms到.NET MAUI后自定义样式（LabelStyles/FrameStyles/ButtonStyles）失效的问题，结合你已修复颜色问题（System.Drawing.Color导致）的情况，可以从以下几个方面排查和解决：

1. 检查自定义样式文件的生成操作 #

确认每个XAML样式文件的生成操作设置为MauiXaml：

• 在解决方案资源管理器中右键样式文件（如LabelStyles.xaml）→ 属性
• 将「生成操作」改为MauiXaml（Xamarin.Forms中通常是EmbeddedResource，MAUI需要这个新的生成操作才能正确编译加载XAML资源）

2. 验证样式文件的代码后置类 #

确保每个XAML样式对应的.cs文件继承正确且包含初始化代码：

public partial class LabelStyles : ResourceDictionary
{
    public LabelStyles()
    {
        InitializeComponent();
    }
}

如果缺少代码后置类，或构造函数未调用InitializeComponent()，会导致样式无法被正确加载。

3. 确认资源字典合并的时机 #

检查Init方法的调用时机是否在App启动的早期阶段，比如App.xaml.cs的构造函数中：

public App()
{
    InitializeComponent();
    Init(Resources); // 传入App的全局ResourceDictionary
    MainPage = new MainPage();
}

若在MainPage初始化后才合并资源字典，页面元素可能已完成初始化，无法应用样式。

4. 检查样式的TargetType与命名空间 #

确保样式的TargetType指向MAUI的控件类型：

• 避免使用旧的Xamarin.Forms命名空间，MAUI中默认的控件命名空间为Microsoft.Maui.Controls，比如：

  <Style TargetType="Label">
      <!-- 样式定义 -->
  </Style>
  

  若手动指定命名空间，需确保是MAUI的命名空间而非Xamarin.Forms的。

5. 排查样式优先级与继承 #

• 检查自定义样式是否被MAUI默认样式覆盖，可在样式中显式设置BasedOn属性继承默认样式（如果需要）：

  <Style TargetType="Label" BasedOn="{StaticResource LabelStyle}">
      <!-- 自定义样式内容 -->
  </Style>
  

• 确认样式的x:Key是否正确被控件引用，若样式未设置x:Key，需确保TargetType匹配且控件未设置本地样式覆盖全局样式。

6. 尝试在App.xaml中直接合并资源字典 #

暂时替换代码合并的方式，直接在App.xaml中添加合并字典，验证样式是否能生效：

<Application.Resources>
    <ResourceDictionary>
        <ResourceDictionary.MergedDictionaries>
            <local:LabelStyles />
            <local:FrameStyles />
            <local:ButtonStyles />
        </ResourceDictionary.MergedDictionaries>
    </ResourceDictionary>
</Application.Resources>

如果此方式生效，说明代码合并的时机或逻辑存在问题，可进一步排查Init方法的调用逻辑。

7. 启用MAUI调试日志排查 #

在Program.cs中添加日志配置，查看资源加载的详细日志：

builder.Logging.AddDebug();

在输出窗口中筛选「Debug」日志，查看是否有样式加载相关的警告或错误信息，定位问题根源。

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