执行build_runner build时Flutter 3.32.1出现Dart版本不兼容及语义类错误，求永久解决方案

看起来你遇到的是Dart版本不兼容和Flutter SDK内部API解析异常的双重问题，每次手动clean重启确实折腾人，给你几个能永久解决的思路，按顺序尝试：

• 确保IDE完全绑定FVM管理的Flutter/Dart版本
  不管是Android Studio还是VS Code，都要把项目的SDK彻底切换到FVM里的3.32.1版本：

  • Android Studio：打开File > Project Structure > Project，将项目SDK选为FVM路径下的Flutter 3.32.1；再进入Languages & Frameworks > Flutter，同样指定该路径，Dart SDK会自动关联到对应版本。
  • VS Code：打开项目的.vscode/settings.json，添加或修改：

    "dart.flutterSdkPath": ".fvm/versions/3.32.1",
    "dart.sdkPath": ".fvm/versions/3.32.1/bin/cache/dart-sdk"
    

  • 终端也要确认：执行fvm flutter --version后，输出的Dart版本必须是3.8.1，且路径是FVM的版本目录，避免系统全局的Flutter/Dart干扰。

• 锁定build_runner及相关依赖的兼容版本
  打开项目的pubspec.yaml，在dev_dependencies中指定与Flutter 3.32.1兼容的build_runner版本，比如：

  dev_dependencies:
    build_runner: ^2.4.10
    # 其他如json_serializable等依赖也要同步到兼容版本
  

  修改后执行：

  fvm flutter pub get
  fvm flutter pub run build_runner clean
  

  再重新执行构建命令，避免依赖版本不匹配引发的解析错误。

• 清理全局缓存并重新安装Flutter版本
  旧缓存可能导致版本混乱，执行以下命令彻底清理：

  # 清理FVM缓存
  fvm cache clean
  # 清理Dart全局缓存
  dart pub cache clean
  # 重新安装Flutter 3.32.1（确保SDK文件完整）
  fvm uninstall 3.32.1
  fvm install 3.32.1
  

• 修正项目的Dart语言版本约束
  打开pubspec.yaml的environment段，确保Dart版本范围包含Flutter 3.32.1对应的3.8.1，比如：

  environment:
    sdk: '>=3.8.0 <4.0.0'
  

  不要设置过窄的版本（比如3.6.0），这会直接触发“语言版本过高”的错误提示。

按上述步骤操作后，应该能彻底解决每次构建都报错的问题，不用再手动执行clean和重启IDE了。

内容来源于stack exchange