如何使用CommunityToolkit.Mvvm异步初始化.NET MAUI的ViewModel？

针对你从FreshMvvm迁移到CommunityToolkit.Mvvm时遇到的异步初始化问题，这里有几种实用的替代方案，完全可以替代原来的Init()方法：

1. 定义异步初始化方法，通过页面生命周期触发 #

在ViewModel中封装异步初始化逻辑，然后在页面的OnAppearing或Loaded事件中调用：

ViewModel 代码 #

using CommunityToolkit.Mvvm.ComponentModel;

[ObservableObject]
public partial class YourViewModel
{
    [ObservableProperty]
    private string _data;

    // 异步初始化方法
    public async Task InitializeAsync()
    {
        // 这里写你的异步逻辑，比如从API加载数据
        Data = await YourDataService.FetchDataAsync();
    }
}

页面后台代码 #

protected override async void OnAppearing()
{
    base.OnAppearing();
    if (BindingContext is YourViewModel vm)
    {
        await vm.InitializeAsync();
    }
}

或者使用页面的Loaded事件：

<ContentPage ... Loaded="ContentPage_Loaded">

private async void ContentPage_Loaded(object sender, EventArgs e)
{
    if (BindingContext is YourViewModel vm)
    {
        await vm.InitializeAsync();
    }
}

2. 用RelayCommand封装初始化逻辑，自动触发 #

借助CommunityToolkit.Mvvm的RelayCommand，可以把初始化逻辑包装成命令，然后在页面绑定ViewModel后自动执行：

ViewModel 代码 #

using CommunityToolkit.Mvvm.ComponentModel;
using CommunityToolkit.Mvvm.Input;

[ObservableObject]
public partial class YourViewModel
{
    [ObservableProperty]
    private string _data;

    [RelayCommand]
    private async Task InitializeAsync()
    {
        Data = await YourDataService.FetchDataAsync();
    }
}

页面构造函数中触发命令 #

public YourPage()
{
    InitializeComponent();
    BindingContext = new YourViewModel();
    
    if (BindingContext is YourViewModel vm)
    {
        vm.InitializeCommand.Execute(null);
    }
}

3. 结合依赖注入的异步初始化（适合全局/单例ViewModel） #

如果你的ViewModel是通过依赖注入容器注册的，可以实现IAsyncInitializable接口（来自Microsoft.Extensions.Hosting.Abstractions），在应用启动时完成异步初始化：

ViewModel 代码 #

using CommunityToolkit.Mvvm.ComponentModel;
using Microsoft.Extensions.Hosting;

[ObservableObject]
public partial class GlobalViewModel : IAsyncInitializable
{
    [ObservableProperty]
    private string _globalData;

    public async Task InitializeAsync(CancellationToken cancellationToken = default)
    {
        GlobalData = await YourDataService.FetchGlobalDataAsync();
    }
}

注册DI时配置 #

builder.Services.AddSingleton<GlobalViewModel>();
builder.Services.AddHostedService(sp => sp.GetRequiredService<GlobalViewModel>());

注意事项 #

• 绝对不要在ViewModel的构造函数中直接调用异步方法（会导致异步操作无等待，引发不可预期的线程问题），必须通过await等待初始化完成。
• 如果需要传递初始化参数，可以直接在异步方法中添加参数，从页面传递即可，替代FreshMvvm中Init(object initData)的用法。

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