MAUI SQLite数据库怎么用 MAUI本地数据库操作教程

admin 百科 2025-12-22 13

.NET MAUI中SQLite本地存储需装sqlite-net-pcl和SQLitePCLRaw.bundle_green两包，数据库路径用FileSystem.AppDataDirectory拼接，访问逻辑用SQLiteAsyncConnection异步初始化并操作。

MAUI SQLite数据库怎么用 MAUI本地数据库操作教程-第1张图片-佛山资讯网

在 .NET MAUI 中用 SQLite 做本地数据存储，核心就三件事：装对包、定好路径、写好访问逻辑。不复杂但容易忽略细节，比如少装一个依赖或路径写错，运行时直接报错。

必须安装的两个 NuGet 包

只装 sqlite-net-pcl 不够，它依赖底层 SQLite 实现，必须同步安装对应平台的绑定包：

sqlite-net-pcl（作者：praeclarum）—— 提供 SQLiteAsyncConnection 和模型映射能力
SQLitePCLRaw.bundle_green（不是 bundle_e_sqlite3 或其他变体）—— 为 Android/iOS/macOS/Windows 提供统一的原生 SQLite 支持

如果漏装 bundle_green，App 启动时大概率抛出 System.DllNotFoundException 或初始化失败。

数据库文件路径要写对

MAUI 没有“默认数据库目录”，必须手动拼出可写路径。推荐做法是建一个 Constants.cs：

public static class Constants
{
    public const string DatabaseFilename = "appdata.db3";
    public static string DatabasePath => Path.Combine(FileSystem.AppDataDirectory, DatabaseFilename);
}

登录后复制

注意：FileSystem.AppDataDirectory 在各平台自动指向安全私有目录（如 Android 的 /data/data/{package}/files/），千万别硬编码路径或用 Environment.GetFolderPath。