在 Avalonia 中连接 SQLite 数据库，核心是使用 Microsoft.Data.Sqlite（推荐）或 System.Data.SQLite，配合异步操作适配 Avalonia 的 UI 线程模型。不需要额外的 ORM 也能快速上手，但搭配 Dapper 或 Entity Framework Core 会更高效。
安装必要 NuGet 包
在项目中添加以下包（以 .NET 6/7/8 + Avalonia 11 为例）：
Microsoft.Data.Sqlite（轻量、官方维护、跨平台首选） （可选）Dapper（简化 CRUD，无配置、高性能） （可选）Microsoft.EntityFrameworkCore.Sqlite（如需 EF Core）在终端运行：
dotnet add package Microsoft.Data.Sqlitedotnet add package Dapper
创建数据库与表（代码优先）
避免手动管理 db 文件路径出错。推荐用
Environment.GetFolderPath获取可靠路径，比如放在用户本地应用目录：
string dbPath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), "myapp.db");
using var connection = new SqliteConnection($"Data Source={dbPath}");
connection.Open();
<p>// 创建表（仅首次执行）
using var cmd = connection.CreateCommand();
cmd.CommandText = @"
CREATE TABLE IF NOT EXISTS Users (
Id INTEGER PRIMARY KEY AUTOINCREMENT,
Name TEXT NOT NULL,
Email TEXT UNIQUE
)";
cmd.ExecuteNonQuery();
封装安全的数据库访问服务
Avalonia 是单线程 UI 框架，所有数据库 I/O 必须异步执行，避免阻塞主线程。建议封装为独立服务，例如：
定义接口IDbService，含
Task<list>> GetAllUsers()</list>等方法 实现类中统一管理连接字符串和连接生命周期（每次操作新建连接，不长期持有） 用
await connection.ExecuteAsync(...)或
await connection.QueryAsync<user>(...)</user>（Dapper）
示例片段（Dapper）：
public async Task<List<User>> GetAllUsers()
{
string dbPath = GetDbPath();
using var connection = new SqliteConnection($"Data Source={dbPath}");
await connection.OpenAsync();
return (await connection.QueryAsync<User>("SELECT * FROM Users")).AsList();
}
在 ViewModel 中调用并更新 UI
在 ViewModel 中注入或实例化数据库服务，用
IAsyncRelayCommand触发查询，并用
NotifyPropertyChanged更新绑定属性： 声明
public ObservableCollection<user> Users { get; } = new();</user>
命令执行时：清空集合 → await 查询 → 逐个 Add（或用 ToObservableCollection()）
确保不在 UI 线程直接 await 后直接操作集合，Dapper 返回的 List 可安全遍历
注意：Avalonia 的
ObservableCollection是线程敏感的，所有 Add/Remove 必须在 UI 线程。如果查询后需要更新，可用
Application.Current.Dispatcher.InvokeAsync(() => { ... }) 安全调度。
基本上就这些。SQLite + Microsoft.Data.Sqlite + Dapper 组合在 Avalonia 中稳定、轻量、易调试，适合中小项目快速落地。不用复杂配置，关键点就三个：路径可靠、连接不复用、UI 更新走 Dispatcher。
