Avalonia中读写JSON配置文件需用System.Text.Json操作本地文件,关键在于跨平台路径处理、结构匹配的序列化及线程安全保存。

在 Avalonia 中读写 JSON 配置文件,本质是使用 .NET 标准的 JSON 库(如 System.Text.Json)操作本地文件,Avalonia 本身不提供专属 JSON API,但可轻松集成。关键在于:路径处理要适配跨平台、序列化要匹配配置类结构、保存时注意线程安全(尤其从 UI 线程触发)。
定义配置模型类
先创建一个与 JSON 结构一致的 C# 类,推荐用 public 属性 + 默认构造函数,便于自动序列化:
public class AppConfig
{
public string Theme { get; set; } = "Light";
public int WindowWidth { get; set; } = 800;
public bool AutoSave { get; set; } = true;
public string[] RecentFiles { get; set; } = Array.Empty<string>();
}登录后复制
读取 JSON 配置文件(推荐异步)
使用 System.Text.Json 异步读取,避免阻塞 UI。路径建议放在用户数据目录(跨平台兼容):
- 用
AppDataDirectory获取可靠路径(如 Windows 的%APPDATA%,macOS 的~/Library/Application Support) - 检查文件是否存在,不存在则返回默认配置
- 捕获
JsonException防止格式错误导致崩溃
private static readonly string ConfigPath = Path.Combine(
Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData),
"MyApp", "config.json");
<p>public static async Task<AppConfig> LoadConfigAsync()
{
if (!File.Exists(ConfigPath))
return new AppConfig();</p><pre class="brush:php;toolbar:false;">try
{
var json = await File.ReadAllTextAsync(ConfigPath);
return JsonSerializer.Deserialize<AppConfig>(json) ?? new AppConfig();
}
catch (JsonException ex)
{
Console.WriteLine($"JSON 解析失败: {ex.Message}");
return new AppConfig();
}登录后复制
}
保存 JSON 配置到文件(带格式化和原子写入)
写入时建议启用缩进提升可读性,并用临时文件+重命名实现原子保存(避免写到一半崩溃导致配置损坏):
标签: js json windows app mac ai macos win 配置文件 c# cos .net
还木有评论哦,快来抢沙发吧~