Avalonia等效WPF应用设置功能的实现方案咨询

内置能力说明 #

Avalonia 没有内置与 WPF 应用设置功能完全等效的原生组件。WPF 自带的 Settings 管理是 .NET Framework/Windows 桌面专属的封装能力，跨平台设计的 Avalonia 未默认集成这套机制，这也是你复制原有设置文件后仅能读取、无法调用 Save()/Reset() 方法的原因。

自定义配置持久化实现路径 #

你可以通过以下步骤快速实现和WPF Settings功能一致的配置管理能力，全程无需引入第三方依赖：

1. 定义配置实体类 #

首先创建配置类，直接在属性的默认值处定义配置的初始值：

public class AppSettings
{
    public int WindowWidth { get; set; } = 1200;
    public int WindowHeight { get; set; } = 800;
    public string SelectedTheme { get; set; } = "Light";
    public bool AutoStartEnabled { get; set; } = false;
    // 按需添加其他配置字段
}

2. 封装全局配置管理类 #

通过静态类封装配置的加载、保存、重置逻辑，自动适配跨平台存储路径：

using System.IO;
using System.Text.Json;

public static class AppSettingsManager
{
    private static readonly string _configFilePath;
    public static AppSettings Current { get; private set; } = new();

    static AppSettingsManager()
    {
        // 跨平台获取用户级配置存储目录
        var configRootDir = Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData);
        var appConfigDir = Path.Combine(configRootDir, "替换为你的应用名称");
        Directory.CreateDirectory(appConfigDir);
        _configFilePath = Path.Combine(appConfigDir, "config.json");
    }

    // 应用启动时调用，加载已保存的配置
    public static void Load()
    {
        if (!File.Exists(_configFilePath))
        {
            Current = new AppSettings();
            return;
        }

        try
        {
            var jsonContent = File.ReadAllText(_configFilePath);
            Current = JsonSerializer.Deserialize<AppSettings>(jsonContent) ?? new AppSettings();
        }
        catch
        {
            // 配置文件损坏时自动回退到默认值
            Current = new AppSettings();
        }
    }

    // 修改配置后调用，持久化到本地
    public static void Save()
    {
        var jsonOutput = JsonSerializer.Serialize(Current, new JsonSerializerOptions { WriteIndented = true });
        File.WriteAllText(_configFilePath, jsonOutput);
    }

    // 重置所有配置为默认值
    public static void Reset()
    {
        Current = new AppSettings();
        Save();
    }
}

3. 使用方式 #

和原有WPF的Settings调用逻辑基本一致：

• 应用启动时初始化：在App.axaml.cs的OnFrameworkInitializationCompleted方法中调用AppSettingsManager.Load()
• 读取配置：var theme = AppSettingsManager.Current.SelectedTheme;
• 修改配置：AppSettingsManager.Current.WindowWidth = 1400;
• 保存配置：AppSettingsManager.Save();
• 重置配置：AppSettingsManager.Reset();

可选增强 #

如果需要将配置绑定到UI做实时响应，只需要让AppSettings类实现INotifyPropertyChanged接口即可。

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