跨平台开发 / 系统课时

认识 SQLite 本地数据库

认识 SQLite 本地数据库

本篇将解决 Flutter 应用中结构化数据持久化的问题。你会理解 SQLite 的表、行、查询等核心概念,并通过实际数据库操作了解为什么复杂本地数据通常需要数据库而不是普通文件。

学习目标

  • 理解 SQLite 在 Flutter 本地存储中的作用
  • 掌握表、字段、行和查询之间的关系
  • 了解使用 SQLite 保存结构化数据的基本方式

为什么需要本地数据库

文件适合保存整体数据,但当应用需要管理大量结构化信息时,直接读写文件会产生很多问题。例如待办事项应用需要按完成状态筛选任务,记账应用需要按日期统计消费记录,这些场景都需要高效查询。

SQLite 是一个嵌入式关系数据库,它运行在应用本地,不需要独立数据库服务器。Flutter 应用可以通过数据库插件创建表、执行 SQL,并管理本地业务数据。

理解表、行和字段

SQLite 使用表组织数据。一张表描述一种业务对象,每一行表示一条记录,每一列表示一个属性。

例如任务列表可以设计为:

id title completed
1 学习 Flutter 0
2 完成练习 1

其中:

  • id 用于唯一标识记录
  • title 保存任务内容
  • completed 保存任务状态

当应用需要查找未完成任务时,只需要通过 SQL 条件查询,而不用读取整个文件后再自行过滤。

在 Flutter 中执行 SQLite 操作

Flutter 常使用 sqflite 插件访问 SQLite。下面示例创建数据库、建立表并插入一条数据。

dart
import 'package:sqflite/sqflite.dart';
import 'package:path/path.dart';

Future<Database> openAppDatabase() async {
  final path = join(await getDatabasesPath(), 'app.db');

  return openDatabase(
    path,
    version: 1,
    onCreate: (db, version) async {
      await db.execute(
        'CREATE TABLE tasks(id INTEGER PRIMARY KEY, title TEXT, completed INTEGER)',
      );
    },
  );
}

Future<void> insertTask() async {
  final db = await openAppDatabase();

  await db.insert('tasks', {
    'title': '学习 SQLite',
    'completed': 0,
  });
}

预期结果

text
数据库文件 app.db 创建成功
tasks 表创建成功
插入一条任务记录

示例中的数据库路径由系统管理,应用不需要自行拼接固定存储位置。

查询与数据设计边界

SQLite 的优势在于可以利用 SQL 完成筛选、排序和关联查询。例如查询未完成任务:

sql
SELECT id, title
FROM tasks
WHERE completed = 0;

预期结果

text
id | title
1  | 学习 SQLite

设计数据库时需要提前考虑字段类型、主键和索引。频繁查询的字段通常需要合理建立索引,否则数据量增加后查询性能会下降。

文件存储和 SQLite 的选择

场景 推荐方案
应用配置、少量缓存 文件存储
列表数据、历史记录 SQLite
需要条件查询和排序 SQLite
简单键值数据 键值存储

SQLite 并不是所有本地数据的默认答案。对于简单设置项,文件或键值存储更容易维护;对于需要管理关系和查询能力的数据,SQLite 更合适。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

认识 SQLite 本地数据库

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通