使用Hive做Flutter本地存储时运行build命令无法生成.g.dart文件

你遇到的生成失败问题核心由模型类的两处语法/类型不兼容问题导致，按以下步骤修改即可解决： #

1. 移除不可序列化的Widget类型字段 #

Hive仅支持序列化基础数据类型、List、Map以及自定义的HiveObject类型，Widget是Flutter UI渲染组件，无法被Hive序列化存储。
你可以将对应字段改为可序列化的标识类型，业务层自行映射为对应组件：

// 替换前（错误写法）
@HiveField(4)
Widget fieldType;

// 替换后（正确写法示例）
@HiveField(4)
String fieldTypeKey; // 存储如'textField'、'dropdown'等自定义标识，使用时根据标识生成对应Widget

2. 修正关键字命名冲突 #

required是Dart内置关键字，不能直接用作属性名，需修改为合法变量名：

// 替换前（错误写法）
@HiveField(5)
bool required;

// 替换后（正确写法示例）
@HiveField(5)
bool isRequired;

3. 额外配置检查 #

• 确认pubspec.yaml中已添加完整依赖：

dependencies:
  hive: ^2.2.3
  hive_flutter: ^1.1.0

dev_dependencies:
  hive_generator: ^2.0.1
  build_runner: ^2.4.8

• 确认part指令的文件名前缀和当前源文件完全匹配，例如源文件名为add_form.dart时，必须写part 'add_form.g.dart';，命名不一致会导致生成失败。
• 执行生成命令时添加冲突清理参数，避免旧缓存干扰：
  flutter packages pub run build_runner build --delete-conflicting-outputs

修改完成后重新执行生成命令，即可正常生成对应的.g.dart文件。

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