如何在简易React Native离线清单应用中实现本地数据存储？

针对你的React Native离线清单应用，先明确几个关键点：

• Redux本身是内存状态管理工具，不负责数据持久化到本地设备——如果要用Redux，得搭配redux-persist这类工具把状态同步到本地存储，但如果你的应用逻辑不复杂，其实没必要为了存储特意引入Redux，属于过度设计。

下面是几个适合的本地存储方案，按场景划分：

1. AsyncStorage（官方推荐版：@react-native-async-storage/async-storage） #

适合小型应用、数据结构简单的场景，比如你的清单是基础数组+对象结构。它是键值对存储，需要自己把JSON数据序列化为字符串存储，读取时再反序列化。

示例操作：

import AsyncStorage from '@react-native-async-storage/async-storage';

// 保存清单
const saveLists = async (lists) => {
  try {
    await AsyncStorage.setItem('user_lists', JSON.stringify(lists));
  } catch (e) {
    // 处理存储错误
  }
};

// 获取清单
const getLists = async () => {
  try {
    const value = await AsyncStorage.getItem('user_lists');
    return value != null ? JSON.parse(value) : [];
  } catch (e) {
    // 处理读取错误
  }
};

优点：API简单，无额外依赖，学习成本低；缺点：不支持复杂查询，大量数据下性能一般。

2. Realm #

专为移动设备设计的本地数据库，支持关系型数据模型，自带ORM，非常适配你的「清单+条目」一对多结构。不需要自己处理序列化，直接通过对象操作数据，查询、过滤都很方便，性能远优于AsyncStorage。

示例（定义模型+基础CRUD）：

import Realm from 'realm';

// 定义条目模型
class ListItem extends Realm.Object {}
ListItem.schema = {
  name: 'ListItem',
  properties: {
    id: 'string',
    content: 'string',
    createdAt: 'date',
  },
};

// 定义清单模型
class TodoList extends Realm.Object {}
TodoList.schema = {
  name: 'TodoList',
  properties: {
    id: 'string',
    title: 'string',
    items: 'ListItem[]',
    createdAt: 'date',
  },
};

// 初始化Realm
const realm = await Realm.open({schema: [TodoList, ListItem]});

// 创建清单
realm.write(() => {
  realm.create('TodoList', {
    id: 'list_1',
    title: '购物清单',
    items: [],
    createdAt: new Date(),
  });
});

// 给指定清单添加条目
realm.write(() => {
  const targetList = realm.objects('TodoList').filtered('id = "list_1"')[0];
  targetList.items.push({
    id: 'item_1',
    content: '牛奶',
    createdAt: new Date(),
  });
});

优点：关系型数据支持完善，API友好，性能优异；缺点：引入第三方库，体积略大，但对于离线应用来说完全值得。

3. MMKV #

腾讯开源的高性能键值存储，比AsyncStorage快数倍，支持多进程，适合需要高性能存储、数据量较大的场景。API和AsyncStorage类似，但底层实现更高效，也支持存储JSON数据。

示例：

import { MMKV } from 'react-native-mmkv';

const storage = new MMKV();

// 保存清单
storage.set('user_lists', JSON.stringify(lists));

// 获取清单
const lists = JSON.parse(storage.getString('user_lists') || '[]');

优点：性能极强，API简单，体积小；缺点：不支持关系型查询，适合结构化但无需复杂关联的数据。

4. SQLite（react-native-sqlite-storage 或 Expo SQLite） #

传统关系型数据库，适合需要复杂SQL查询、数据量庞大的场景。如果你熟悉SQL，需要高度定制化的数据操作，这个方案灵活性最高。

示例（创建表+插入数据）：

import SQLite from 'react-native-sqlite-storage';

const db = SQLite.openDatabase({name: 'TodoDB.db'});

// 创建清单和条目表
db.transaction(tx => {
  tx.executeSql(
    'CREATE TABLE IF NOT EXISTS lists (id TEXT PRIMARY KEY, title TEXT, createdAt INTEGER)',
    [],
    () => console.log('清单表创建成功'),
    (_, error) => console.error(error)
  );
  tx.executeSql(
    'CREATE TABLE IF NOT EXISTS items (id TEXT PRIMARY KEY, listId TEXT, content TEXT, createdAt INTEGER, FOREIGN KEY(listId) REFERENCES lists(id))',
    [],
    () => console.log('条目表创建成功'),
    (_, error) => console.error(error)
  );
});

// 插入新清单
db.transaction(tx => {
  tx.executeSql(
    'INSERT INTO lists (id, title, createdAt) VALUES (?, ?, ?)',
    ['list_1', '购物清单', Date.now()],
    (_, result) => console.log('清单插入成功'),
    (_, error) => console.error(error)
  );
});

优点：灵活性最高，支持复杂查询；缺点：需要编写SQL语句，学习成本较高，代码量相对大。

选择建议 #

• 如果应用功能简单，清单和条目结构不复杂，优先选MMKV（性能好）或AsyncStorage（入门快）；
• 如果清单和条目是明确的一对多关系，需要频繁根据清单过滤条目，选Realm，开发效率最高；
• 如果需要复杂的统计、查询逻辑，且你熟悉SQL，选SQLite；
• 如果已经在用Redux管理应用状态，搭配redux-persist，可以把上述任意一种存储作为持久化引擎，实现状态自动持久化。

内容的提问来源于stack exchange，提问作者Hypo