如何在 Flutter 中本地持久化数据？

Question

Accepted Answer

应用程序通常需要**在设备上本地存储数据**——用户偏好设置、缓存数据、离线内容。Flutter 提供了几个选项——**shared_preferences**（键值存储）、**SQLite**（关系型数据库）等——每个都适合不同的需求。

## 本地存储选项

```text
SHARED_PREFERENCES → simple KEY-VALUE storage (settings, flags, small data):
  → store primitives (strings, ints, bools) — like a simple persistent map
  → for: user preferences, tokens, simple flags (NOT large/structured data)
SQLITE (sqflite) → a full relational DATABASE on the device:
  → tables, SQL queries — for STRUCTURED, larger data; complex queries; relationships
HIVE / ISAR → fast NoSQL local databases (key-value/object stores) — popular, fast,
  Dart-native (no SQL); good for structured local data
FILE storage → read/write files directly (path_provider for directories)
SECURE storage → flutter_secure_storage for SENSITIVE data (tokens, credentials) —
  encrypted (keychain/keystore)
```

## shared_preferences 示例

```dart
final prefs = await SharedPreferences.getInstance();
await prefs.setString('username', 'Ann');      // store
final name = prefs.getString('username');        // retrieve
await prefs.setBool('darkMode', true);
```

## 选择合适的选项

```text
Simple settings/flags → shared_preferences (easy key-value)
Structured/large data, queries → SQLite (sqflite) or Hive/Isar
Sensitive data (tokens, passwords) → flutter_secure_storage (ENCRYPTED — don't put
  secrets in shared_preferences, which is NOT secure)
Files → file storage (path_provider)
→ Match the storage to the data's size, structure, and sensitivity.
```

## 为什么这很重要

理解如何本地持久化数据非常有价值，因为**应用程序通常需要在设备上存储数据**——用户偏好设置、缓存数据、离线内容、身份验证令牌——所以这是构建真实应用程序的实用知识。

本地持久化是近乎通用的需求（记住设置、为离线使用缓存、存储会话数据），Flutter 提供了几个适合不同需求的选项。

理解**各个选项**——**shared_preferences**（用于设置、标志和小型数据的简单键值存储）、**SQLite/sqflite**（用于具有查询和关系的结构化大型数据的完整关系型数据库）、**Hive/Isar**（用于结构化本地数据的快速 Dart 原生 NoSQL 数据库）、文件存储和**安全存储**（`flutter_secure_storage` 用于敏感数据）——以及**何时使用每个选项**是关键知识。

选择**合适的选项**很重要：简单设置使用 shared_preferences，结构化/大型数据使用 SQLite 或 Hive/Isar，文件使用文件存储，最关键的是**为敏感数据使用安全存储**，如令牌和凭证（必须通过平台密钥链/密钥库进行加密——一个重要的安全要点，因为**shared_preferences 不安全，不应该保存秘密**，这是常见的错误）。

将存储方式与数据的大小、结构和敏感性匹配反映了合理的决策，并避免了问题（如使用错误的工具或不安全地存储凭证）。

由于应用程序通常需要本地持久化（设置、缓存、离线数据、令牌），Flutter 为不同的需求提供了几个选项，并且理解它们并进行适当的选择（特别是为敏感数据使用安全存储）对于正确构建真实应用程序很有价值，所以理解 Flutter 中的本地数据持久化是有价值的、实践相关的知识——是真实应用程序中的常见需求，对功能（以正确的方式存储正确的数据）和安全性（用安全存储保护敏感数据）都很重要，也是构建能够记住状态并离线工作的应用程序的有用技能。