AsyncStorage 是 React Native 提供的异步存储解决方案,适合保存轻量级数据(如用户偏好、缓存等)。它基于 SQLite,但通过抽象层简化了操作。以下是核心用法与注意事项:


🧰 基本操作示例

  1. 存储数据

    import { AsyncStorage } from 'react-native';
    await AsyncStorage.setItem('key', 'value');
    
    AsyncStorage_Store
  2. 读取数据

    const value = await AsyncStorage.getItem('key');
    console.log(value); // 输出: value
    
  3. 删除数据

    await AsyncStorage.removeItem('key');
    
  4. 清空所有数据

    await AsyncStorage.clear();
    

⚠️ 注意事项

  • 数据类型限制:仅支持字符串,若需存储对象需先 JSON.stringify
  • 并发问题:多线程操作可能导致数据覆盖,建议使用 @react-native-async-storage/async-storage 的封装库
  • 安全性:敏感数据(如密码)不建议使用 AsyncStorage,可考虑 Secure Storage 方案

📈 进阶技巧

  • 使用 AsyncStorage.mergeItem 合并键值对
  • 通过 AsyncStorage.getAllKeys 获取所有存储的键
  • 结合 react-native-keychain 实现加密存储(需额外安装)

🌐 相关资源


如需进一步学习,可点击 React Native 本地存储最佳实践 深入了解安全方案与性能优化。