在移动应用开发领域，本地数据存储始终是开发者必须面对的核心议题。.NET MAUI作为微软推出的跨平台UI框架，支持iOS、Android、macOS和Windows，其与SQLite的深度集成使得离线数据管理变得高效而简洁。本文将详细解析在.NET MAUI应用程序中创建SQLite表的具体步骤，并附上实用代码示例，帮助开发者快速上手。

一、为什么选择SQLite？

SQLite是一款轻量级、无需配置的嵌入式关系数据库引擎，广泛用于移动端和桌面端应用。对于.NET MAUI项目而言，它具备以下优势： - 零服务器：无需安装数据库服务，直接以文件形式存储。 - 跨平台兼容：所有目标平台均支持SQLite。 - 高效读写：尤其适合本地缓存、配置存储等场景。 - 成熟生态：社区提供了sqlite-net-pcl等便捷库，极大简化了操作。

二、准备工作：安装NuGet包

在Visual Studio中创建.NET MAUI项目后，首先需要通过NuGet包管理器安装SQLite依赖。推荐使用sqlite-net-pcl（兼容所有平台），该库不仅封装了CRUD操作，还支持通过特性（Attributes）定义表结构。

操作步骤： 1. 右键项目 → 选择“管理NuGet程序包”。 2. 搜索并安装sqlite-net-pcl（最新稳定版）。 3. 如需异步操作，可同时安装SQLiteAsync扩展（可选）。

三、定义数据模型：用类映射表结构

在SQLite中，一张表对应一个C#类。通过[Table]、[PrimaryKey]、[AutoIncrement]等特性，可以精确控制字段属性和约束。

示例：创建一个记录用户信息的表

using SQLite;

[Table("Users")]
public class User
{
    [PrimaryKey, AutoIncrement]
    public int Id { get; set; }

    [MaxLength(50), NotNull]
    public string Name { get; set; }

    [Unique]
    public string Email { get; set; }

    public int Age { get; set; }
}
  • [PrimaryKey, AutoIncrement]：设置自增主键。
  • [MaxLength(50)]：限制字符串长度（SQLite实际为非强制约束，但有助于代码规范）。
  • [NotNull]：确保字段非空。
  • [Unique]：保证邮箱唯一性。

四、创建数据库与表：核心代码实现

4.1 初始化数据库连接

建议在MauiProgram.cs或专用服务类中注册数据库实例，以确保全局单例。以下演示直接在MainPage的构造函数中初始化：

using SQLite;

public partial class MainPage : ContentPage
{
    private SQLiteAsyncConnection _database;

    public MainPage()
    {
        InitializeComponent();
        InitializeDatabase();
    }

    private async Task InitializeDatabase()
    {
        // 定义数据库文件路径（平台特定）
        string dbPath = Path.Combine(FileSystem.AppDataDirectory, "mydb.db3");

        // 创建异步连接
        _database = new SQLiteAsyncConnection(dbPath);

        // 创建表（如果不存在）
        await _database.CreateTableAsync<User>();
    }
}

关键说明： - FileSystem.AppDataDirectory：自动获取各平台的应用数据目录（如iOS的Document、Android的data/data/...）。 - CreateTableAsync：该方法会检查表是否存在，若不存在则自动创建；若已存在且模型无变更，则忽略；若模型有新增字段，需手动迁移（详见下文）。

4.2 验证表创建成功

执行上述代码后，可通过SQLite工具（如DB Browser for SQLite）打开生成的mydb.db3文件，确认Users表已包含Id、Name、Email、Age四列，且主键为Id。

五、进阶技巧与常见陷阱

5.1 处理模型变更（迁移）

当应用升级导致表结构变化（如新增字段），直接调用CreateTableAsync不会自动添加列。解决方法： - 方案一：使用MigrateAsync方法（sqlite-net-pcl 1.6+支持），或手动执行ALTER TABLE语句。 - 方案二：删除旧表后重建（仅适用于开发阶段）：

await _database.DropTableAsync<User>();
await _database.CreateTableAsync<User>();

生产环境中应谨慎使用，避免数据丢失。

5.2 线程安全

SQLiteAsyncConnection是线程安全的，但同一时间避免对同一连接执行多个写操作。建议在MVVM模式下通过单一数据库实例操作。

5.3 索引优化

对于频繁查询的字段，可添加[Indexed]特性：

[Indexed]
public string Email { get; set; }

六、实战总结

在.NET MAUI中创建SQLite表并不复杂，核心步骤可归纳为： 1. 安装sqlite-net-pcl包。 2. 定义带有SQLite特性的模型类。 3. 初始化数据库连接并调用CreateTableAsync。

这一流程同样适用于多表场景——只需为每个模型重复调用CreateTableAsync即可。通过SQLite，开发者可以轻松为MAUI应用添加离线存储能力，从而提升用户体验，降低对网络状态的依赖。

延伸思考：在实际项目中，建议将数据库操作封装为仓储（Repository）模式，结合依赖注入（DI）实现解耦。后续我们还将探讨如何使用SQLite进行增删改查（CRUD）以及复杂查询优化，敬请关注。

（全文约950字）