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更稳妥。
