Riverpod注解编译错误：按指南操作新项目仍报错

1. 核对依赖配置 #

先确认pubspec.yaml里的依赖是否齐全且版本兼容：

• dependencies区块必须包含：

  flutter_riverpod: ^2.3.0
  riverpod_annotation: ^2.1.1
  

• dev_dependencies区块必须包含：

  riverpod_generator: ^2.2.0
  build_runner: ^2.4.4
  

配置完执行flutter pub get拉取所有依赖。

2. 修正part语句的路径 #

错误提示里的package:pods/main.g.dart说明你的part语句路径不对：

• 如果main.dart在lib/根目录，直接用相对路径：

  part 'main.g.dart';
  

• 不要用package:<项目名>/main.g.dart的形式，除非你的文件不在lib根目录下。

3. 规范注解代码写法 #

要生成helloWorldProvider，必须用@riverpod注解正确的函数，示例代码如下：

import 'package:riverpod_annotation/riverpod_annotation.dart';

part 'main.g.dart';

@riverpod
String helloWorld(HelloWorldRef ref) {
  return 'Hello World';
}

注意：函数名需为小驼峰格式，注解会自动生成同名的Provider（比如上面的helloWorld对应helloWorldProvider）。

4. 重新执行build_runner命令 #

先清理旧的生成缓存：

dart run build_runner clean

然后重新启动监听：

dart run build_runner watch

执行时留意终端输出，如果有语法错误、依赖冲突等报错，先解决这些问题——这些是导致生成文件失败的常见原因。

5. 清除IDE缓存 #

如果以上步骤做完还是报错，大概率是IDE缓存问题：

• 重启Android Studio/VS Code
• 执行flutter clean，再重新跑flutter pub get和build_runner命令

额外排查点 #

• 检查main.dart同目录下是否生成了main.g.dart文件，没有的话看build_runner的终端输出找具体错误
• 确认Dart SDK版本在2.19以上（Riverpod注解对SDK版本有要求）
• 注解函数里不能有语法错误，比如缺分号、参数类型错误，这些会直接导致生成失败

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