如何在MauiProgram.cs中全局引用Colors.xaml解决DI加载资源顺序问题？

问题根源 #

通过DI将MainPage注入App构造函数时，App.xaml中定义的资源字典尚未完成加载，而MainPage.InitializeComponent()会立即尝试解析Primary这类静态资源，因此抛出资源不存在的异常。

无需逐个页面配置的全局方案 #

以下两种方案都能解决问题，无需在每个页面重复添加资源引用：

方案1：调整App构造函数执行顺序（最简单）

直接修改App.xaml.cs的构造函数，确保App自身的资源先初始化完成，再设置MainPage：

public App(MainPage mainPage)
{
    // 先初始化App的资源字典（加载App.xaml中的资源）
    InitializeComponent();
    // 再赋值MainPage，此时资源已就绪
    MainPage = mainPage;
}

这种方式不需要额外修改其他文件，仅调整执行顺序就能让MainPage初始化时访问到App级别的静态资源。

方案2：在MauiProgram中提前加载全局资源（更灵活）

如果需要更灵活的资源管理，可以在MauiProgram.cs中提前加载资源字典并注册为单例，确保DI解析页面时资源已准备好：

1. 在CreateMauiApp中加载并注册资源：

using Microsoft.Maui.Controls.Xaml;

public static MauiApp CreateMauiApp()
{
    var builder = MauiApp.CreateBuilder();
    builder
        .UseMauiApp<App>()
        .ConfigureFonts(fonts =>
        {
            fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
        });

    // 加载Colors.xaml
    var colorsDict = new ResourceDictionary { Source = new Uri("Resources/Styles/Colors.xaml", UriKind.Relative) };
    // 加载Styles.xaml并合并Colors资源
    var stylesDict = new ResourceDictionary { Source = new Uri("Resources/Styles/Styles.xaml", UriKind.Relative) };
    stylesDict.MergedDictionaries.Add(colorsDict);

    // 合并为全局资源字典
    var globalResources = new ResourceDictionary();
    globalResources.MergedDictionaries.Add(colorsDict);
    globalResources.MergedDictionaries.Add(stylesDict);

    // 注册为单例
    builder.Services.AddSingleton(globalResources);

    // 注册页面
    builder.Services.AddTransient<MainPage>();

    return builder.Build();
}

2. 修改App.xaml引用全局资源：

<Application xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="YourAppNamespace.App">
    <Application.Resources>
        <ResourceDictionary>
            <ResourceDictionary.MergedDictionaries>
                <StaticResource ResourceKey="ResourceDictionary" />
            </ResourceDictionary.MergedDictionaries>
        </ResourceDictionary>
    </Application.Resources>
</Application>

3. 在App.xaml.cs中注入并关联资源：

public App(ResourceDictionary globalResources, MainPage mainPage)
{
    InitializeComponent();
    // 将全局资源加入App的资源字典，供所有页面继承
    Resources.MergedDictionaries.Add(globalResources);
    MainPage = mainPage;
}

注意事项 #

• 使用方案1时，确保InitializeComponent()始终在MainPage = mainPage之前执行。
• 使用方案2时，删除所有页面中重复的Colors.xaml和Styles.xaml引用，避免资源重复加载。

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