Avalonia复用.NET标准HttpClient，需单例管理、异步请求并更新ViewModel属性触发UI刷新，注意错误处理、取消令牌及线程安全。
Avalonia 本身不提供专门的 HTTP 客户端，它复用 .NET 标准的 HttpClient —— 和 WinForms、WPF、控制台程序完全一样。你不需要 Avalonia 特有的“网络组件”，直接用 System.Net.Http.HttpClient 即可，但要注意线程上下文和 UI 更新的安全性。
基础用法：创建并复用 HttpClient 实例
别在每次请求时 new HttpClient() —— 这容易引发端口耗尽和 DNS 缓存问题。推荐用单例或 DI 注入方式管理：
- 在
Program.cs或App.xaml.cs中注册为单例（使用 Avalonia 的 DI 容器）：
然后在 ViewModel 或页面中通过构造函数注入使用：
public class MainViewModel(HttpClient client) { ... }发起 GET 请求并更新 UI
Avalonia 是基于绑定的 UI 框架，网络请求必须在后台线程执行，结果返回后才能安全更新 ViewModel 属性（触发 UI 刷新）。推荐用 async/await + NotifyPropertyChanged 模式：
- 定义一个可绑定的属性（比如
public string? Data { get; set; }） - 在命令方法中调用异步请求，并用
await等待结果 - 赋值给属性后，Avalonia 自动刷新绑定控件（如
TextBlock）
var response = await _httpClient.GetAsync("https://api.example.com/data");
Data = await response.Content.ReadAsStringAsync();
}
处理 POST、JSON 序列化与错误
发送 JSON 数据常用 JsonContent（.NET 6+）或手动构造 StringContent：
- POST JSON 示例：
var content = JsonContent.Create(json);
var response = await _httpClient.PostAsync("https://api.example.com/users", content);
- 检查状态码再读取内容，避免异常中断：
Result = await response.Content.ReadAsStringAsync();
else
ErrorMessage = $"请求失败：{response.StatusCode}";
注意跨线程与取消请求
Avalonia 的 UI 线程不是 STA（不像 WPF），但依然禁止从非 UI 线程直接修改控件属性。不过只要更新的是 ViewModel 的 INotifyPropertyChanged 属性，就无需手动切回主线程 —— Avalonia 绑定系统会自动处理。
- 如需支持取消（比如用户点了“停止”按钮），传入
CancellationToken - 可在 ViewModel 中保存
CancellationTokenSource，并在需要时调用Cancel()
_cts = new CancellationTokenSource();
await _httpClient.GetAsync(url, _cts.Token);
基本上就这些 —— Avalonia 的 HTTP 请求就是标准 .NET 的 HttpClient，重点在于正确管理生命周期、异步更新绑定属性、以及按需处理错误和取消。不复杂但容易忽略复用和线程安全细节。
