Flutter中如何使用Hive保存数据到本地，数据库文件存放在哪里

在Flutter项目中，我已经引入了Hive用于本地数据存储，但不太清楚具体如何操作。请问应该如何初始化Hive并保存数据？另外，Hive生成的数据库文件默认存放在设备的哪个路径下？不同平台（Android/iOS）的存储位置是否有区别？如果需要自定义存储路径又该怎么实现？

2 回复

在Flutter中使用Hive保存数据：

  1. 初始化Hive并指定存储路径（通常在应用文档目录）。
  2. 定义数据模型并注册适配器。
  3. 使用Hive.box打开或创建盒子，通过box.put和box.get存取数据。

数据库文件默认存储在设备的应用文档目录（如Android的/data/data/<package>/app_flutter，iOS的Documents目录）。

更多关于Flutter中如何使用Hive保存数据到本地，数据库文件存放在哪里的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


在Flutter中使用Hive保存本地数据，主要包括以下步骤：

1. 添加依赖

在 pubspec.yaml 中添加：

dependencies:
  hive: ^2.2.3
  hive_flutter: ^1.1.0

dev_dependencies:
  hive_generator: ^2.0.0
  build_runner: ^2.4.0

2. 初始化Hive

在 main() 中初始化：

import 'package:hive_flutter/hive_flutter.dart';

void main() async {
  await Hive.initFlutter();
  runApp(MyApp());
}

3. 打开Box（数据库容器）

var box = await Hive.openBox('myBox');

4. 基本操作

// 写入数据
box.put('name', 'John');
box.put('age', 25);

// 读取数据
String name = box.get('name');
int age = box.get('age');

// 删除数据
box.delete('name');

// 清空所有数据
box.clear();

5. 使用模型类（可选）

通过注解生成TypeAdapter：

import 'package:hive/hive.dart';

@HiveType(typeId: 0)
class Person {
  @HiveField(0)
  String name;
  
  @HiveField(1)
  int age;
  
  Person(this.name, this.age);
}

运行生成命令：

flutter packages pub run build_runner build

数据库文件位置

  • Android: /data/data/<package_name>/app_flutter/
  • iOS: Documents 目录下的 hive 文件夹
  • Windows/Linux/macOS: 运行应用的当前工作目录

可以通过以下方式获取路径：

import 'package:path_provider/path_provider.dart';

Future<String> getHivePath() async {
  var dir = await getApplicationDocumentsDirectory();
  return dir.path;
}

注意事项

  • 默认使用AES加密（可选）
  • 支持复杂数据类型和自定义对象
  • 性能优于SharedPreferences
  • 支持Web平台

建议在应用启动时初始化Hive，并在使用完成后调用 box.close() 关闭Box以释放资源。

回到顶部