使用Riverpod的@riverpod注解时遇‘HelloWorldRef未定义’错误

问题原因及解决步骤 #

• 确认依赖配置完整
  打开pubspec.yaml，确保已添加以下依赖（使用当前最新稳定版本即可）：

  dependencies:
    flutter:
      sdk: flutter
    riverpod: ^2.3.0
  
  dev_dependencies:
    flutter_test:
      sdk: flutter
    riverpod_generator: ^2.3.0
    build_runner: ^2.4.0
  

  保存后执行flutter pub get拉取依赖。

• 运行代码生成命令
  在终端执行以下命令，让Riverpod的代码生成器自动生成HelloWorldRef这类辅助类：

  # 实时监听文件变化自动生成（开发时推荐）
  flutter pub run build_runner watch
  # 或一次性生成代码
  flutter pub run build_runner build
  

• 添加part导入声明
  在包含@riverpod注解的dart文件顶部（所有其他导入之前），添加生成文件的导入声明：

  part '你的文件名.g.dart';
  

  比如你的文件叫home.dart，就写part 'home.g.dart';。

完成以上步骤后，HelloWorldRef类会被自动生成，对应的错误即可消除。

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