使用Hive的PersonModel类无法自动生成person_model.g.dart文件

你的PersonModel代码如下：

import 'package:flutter/material.dart';
import 'package:hive/hive.dart';

part 'person_model.g.dart';

@HiveType(typeId: 1)
class PersonModel extends HiveObject {
  @HiveField(0)
  int personID = UniqueKey().hashCode;

  @HiveField(1)
  String personName = "";

  @HiveField(2)
  double personWeight = 0.0;

  @HiveField(3)
  double personHeight = 0.0;

  @HiveField(4)
  double personBMI = 0.0;

  @HiveField(5)
  bool personHasGoodBMI = false;

  PersonModel();

  PersonModel.create(this.personID, this.personName, this.personWeight,
      this.personHeight, this.personBMI, this.personHasGoodBMI);
}

以下是可能的原因及排查方向：

• 文件路径与part声明不匹配
  检查part 'person_model.g.dart';的路径是否正确：

  • 若当前dart文件在子目录（如lib/models/），需确保part路径是相对当前文件的正确路径；
  • 注意文件名大小写，部分系统（如Linux/macOS）区分大小写，若原文件名为PersonModel.dart，part声明的小写路径会导致生成文件无法匹配。

• build_runner缓存异常
  build_runner的缓存可能导致生成逻辑静默失败，即使控制台显示成功。执行以下命令清理缓存后重新构建：

  dart run build_runner clean
  dart run build_runner build --delete-conflicting-outputs
  

• Hive依赖配置不全
  检查pubspec.yaml是否添加了必要的开发依赖：

  dev_dependencies:
    hive_generator: ^1.1.5 # 需与hive版本兼容
    build_runner: ^2.4.6
  

  执行dart pub get确保依赖安装完成。

• 注解或实体配置问题

  • 确认@HiveType(typeId: 1)的typeId在项目中唯一，若与其他Hive实体重复，会导致生成逻辑异常；
  • 检查所有字段的@HiveField序号是否连续且无重复，确保注解无拼写错误（如误写为@HiveType）。

• IDE文件显示限制
  部分IDE默认隐藏生成的.g.dart文件，或未即时刷新文件列表：

  • 直接到系统文件管理器中查看当前dart文件所在目录，确认生成文件是否存在；
  • 在IDE中执行刷新操作（如VS Code按F5或右键刷新，Android Studio按Ctrl+Alt+Y），或调整IDE设置显示生成文件。

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