Avalonia 中必须通过 Dispatcher.UIThread 调度 UI 操作，常用方式包括 Application.Current?.Dispatcher.UIThread 或控件的 Dispatcher.UIThread；支持 InvokeAsync（同步等待）、Post（异步不等待）和 CheckAccess（线程判断）。
Avalonia 中访问和操作 UI 线程，核心靠 Dispatcher.UIThread —— 它是 Avalonia 的主线程调度器，类似 WPF 的 Dispatcher 或 WinUI 的 DispatcherQueue。直接在非 UI 线程更新控件会抛异常，必须通过它“派发”回 UI 线程执行。
获取 UIThread 实例
最常用方式是从任意 UI 元素（如 Window、Control、Application）获取：
-
Application.Current?.Dispatcher.UIThread（推荐，全局可用） -
this.Dispatcher.UIThread（在继承自Control或Window的类中） -
myButton.Dispatcher.UIThread（任意已附加到可视树的控件）
⚠️ 注意：确保控件已加载（Loaded 事件后），否则 Dispatcher 可能为 null。
同步执行 UI 操作（Invoke）
用 Invoke 阻塞当前线程，直到 UI 操作完成。适合需要立即拿到结果的场景（如弹窗确认后继续逻辑）：
await Dispatcher.UIThread.InvokeAsync(() =>
{
myTextBlock.Text = "已更新";
myButton.IsEnabled = false;
});
支持返回值：
var result = await Dispatcher.UIThread.InvokeAsync(() =>
{
return MessageBox.Show("确定？", "提示");
});
异步调度（Post）
用 Post 发起非阻塞调度，不等待执行完成，适合纯 UI 更新、日志、状态刷新等：
Dispatcher.UIThread.Post(() => myProgress.Value++);- 可传入
DispatcherPriority控制优先级（如Background、Normal、Render）
例如：后台任务中频繁更新进度条，用 Post 避免阻塞工作线程。
判断是否已在 UI 线程
用 CheckAccess() 快速判断当前线程是否为 UI 线程，避免不必要的调度：
if (Dispatcher.UIThread.CheckAccess())
{
myTextBlock.Text = "直接更新";
}
else
{
await Dispatcher.UIThread.InvokeAsync(() => myTextBlock.Text = "调度更新");
}
常用于 ViewModel 或服务层中做线程安全封装。
基本上就这些。Avalonia 的 UIThread 设计简洁，没有 WPF 那么多重载，但 InvokeAsync + Post + CheckAccess 已覆盖绝大多数 UI 线程交互需求。关键记住：只要不是从 Loaded 后的 UI 对象或 Application.Current 拿的 Dispatcher，就可能为空；更新前先判空或用 TryGet 更稳妥。