Avalonia 不提供内置 PersistedState,因其专注 UI 渲染而非状态持久化;开发者需自主选择 JSON、SQLite、LiteDB 或平台原生机制实现,并注意异步防抖、路径权限与敏感数据安全。
Avalonia 本身
没有内置名为的类或模块
。你看到的 `PersistedState` 类(如 `com.
microsoft
.bot.dialogs.PersistedState`)属于 Microsoft Bot Framework,与 Avalonia 无关——这是常见混淆点。
为什么 Avalonia 不提供 PersistedState?
Avalonia 是 UI 框架,专注跨平台渲染和交互,
不负责状态持久化逻辑
。它把数据存储交由开发者自主选择:文件、SQLite、JSON 配置、系统设置或第三方库。所谓 “Avalonia 中的 PersistedState”,实际是开发者自行实现的状态序列化 + 存储方案。
在 Avalonia 中实现状态持久化的常用方式
以下方法均已在 Avalonia 11+ 生产项目中验证有效:
Trae win
Trae Windows 官方版本现已全面支持 Win10 和 Win11 系统(64位)。国内开发者可直接访问 Trae 中文官网(trae.cn 或 trae.com.cn),一键下载官方正版 .exe 安装包,享受国内直连的高速稳定体验。安装过程极其简便,双击即可运行,并支持一键无缝导入 VS Code 或 Cursor 的原有主题、快捷键及插件配置。登录支持手机号、微信或稀土掘金账号。内置免费的豆包与 DeepSeek 等顶级大模型,让你开箱即用,轻松开启高效的 AI 智能编程之旅。
下载
使用保存/读取 JSON 配置
利用 Avalonia 内置的跨平台文件访问接口,安全写入用户偏好、窗口尺寸、主题等轻量状态:
结合 SQLite 或 LiteDB 做结构化持久化
适合需要查询、版本控制或离线同步的场景(如笔记应用、本地数据库管理器):
添加
NuGet 包
在 App 初始化时打开数据库:
将 ViewModel 状态对象直接映射为集合(如
)
利用平台原生机制(推荐用于系统级设置)
Windows:通过
(需启用 WinUI 兼容层)
mac
OS/Linux:使用
路径,配合
避免踩坑的关键细节
实际开发中容易忽略但影响体验的几点:
异步写入要防抖
:不要每次属性变更都立刻存盘,建议加 300ms 延迟或使用
脱离 UI 线程
路径权限需显式处理
:Linux/macOS 下
可能不存在,首次使用前应
敏感数据勿明文存 localStorage 类位置
:密码、token 等应交由系统密钥环(如
/
/
)
版本迁移要预留字段
:JSON 结构升级时,用
和默认值兼容旧数据
不复杂但容易忽略——Avalonia 的状态持久化,核心是选对存储媒介 + 控制好序列化时机 + 尊重各平台约定。没有银弹,但有清晰路径。
PersistedStateIStorageProvidervar storage = TopLevel.GetTopLevel(this)!.StorageProvider;
var file = await storage.TryGetFileFromPathAsync(new Uri("user-settings.json"));
if (file != null) {
await using var stream = await file.OpenReadAsync();
var json = await new StreamReader(stream).ReadToEndAsync();
settings = JsonSerializer.Deserialize(json);
} LiteDBnew LiteDatabase("data.db")db.GetCollection("windows") Windows.Storage.ApplicationData.Current.LocalSettings~/.config/your-app/config.jsonEnvironment.GetFolderPath(Environment.SpecialFolder.ApplicationData)Task.Run(() => SaveAsync())~/.configDirectory.CreateDirectory()libsecretKeychainWindows Credential Manager[JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]