Flutter开发：final变量'champion'未初始化问题求助

问题描述 #

我定义了一个存储Champion数据的agentMap，想要在DetailView的状态类_DetailViewState中使用其中的数据，但调用时出现错误提示：“The final variable 'champion' must be initialized. Try initializing the variable”。相关代码如下：

DetailView状态类代码 #

class _DetailViewState extends State<DetailView> {
  final Champion champion;

  @override
  Widget build(BuildContext context) {
    return Scaffold(
        backgroundColor: Colors.black45,
        body: Stack(children: [
          Container(
              height: 300, child: Image.asset("images/brimstone-valo.jpg")),

Champion类及agentMap代码 #

import 'package:valorant_heros/constants/constant.dart';

class Champion {
  late String name;
  late String nickName;
  late Role role;
  late Difficulty difficulty;
  late String image;
  late String description;

  Champion(
      { required this.name,
       required this.nickName,
       required this.role,
       required this.difficulty,
       required this.image,
       required this.description});
}

var agentMap = {
  "brimstone": Champion(
      name: "Brimstone",
      nickName: "aa",
      role: Role.CONTROLADOR,
      difficulty: Difficulty.FACIL,
      image: "images/brimstone-valo.jpg",
      description:
          'Vindo diretamente dos EUA, o arsenal orbital de Brimstone garante que o esquadrão dele esteja sempre em vantagem. Sua capacidade de oferecer utilidade com precisão a distância faz dele um comandante inigualável na linha de frente.'),
 

解决方案 #

Dart中final修饰的变量必须在声明时或类的构造函数中完成初始化，不能留空。结合你的场景，有两种常用解决方式：

方式一：从父Widget（DetailView）传递Champion实例 #

1. 修改DetailView类，添加Champion类型的必填参数：

class DetailView extends StatefulWidget {
  final Champion champion;

  const DetailView({Key? key, required this.champion}) : super(key: key);

  @override
  _DetailViewState createState() => _DetailViewState();
}

2. 在状态类中通过widget.champion直接访问数据，无需单独声明final变量：

class _DetailViewState extends State<DetailView> {
  // 移除原有的final Champion champion;

  @override
  Widget build(BuildContext context) {
    return Scaffold(
        backgroundColor: Colors.black45,
        body: Stack(children: [
          Container(
              height: 300, child: Image.asset(widget.champion.image)),
          // 其他需要使用champion数据的代码
        ]));
  }
}

3. 跳转至DetailView时传入对应英雄实例：

Navigator.push(
  context,
  MaterialPageRoute(
    builder: (context) => DetailView(champion: agentMap["brimstone"]!),
  ),
);

方式二：直接从agentMap初始化champion #

如果DetailView固定展示某个英雄，或可通过路由参数获取英雄标识，可直接在状态类中完成初始化：

• 固定英雄场景：

class _DetailViewState extends State<DetailView> {
  final Champion champion = agentMap["brimstone"]!; // 直接从map中获取初始化

  @override
  Widget build(BuildContext context) {
    return Scaffold(
        backgroundColor: Colors.black45,
        body: Stack(children: [
          Container(
              height: 300, child: Image.asset(champion.image)),
          // 其他使用champion数据的代码
        ]));
  }
}

• 路由传参动态获取场景：

class _DetailViewState extends State<DetailView> {
  late final Champion champion; // 用late final实现延迟初始化

  @override
  void initState() {
    super.initState();
    // 从路由参数中获取英雄标识
    String heroKey = ModalRoute.of(context)!.settings.arguments as String;
    champion = agentMap[heroKey]!;
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
        backgroundColor: Colors.black45,
        body: Stack(children: [
          Container(
              height: 300, child: Image.asset(champion.image)),
          // 其他使用champion数据的代码
        ]));
  }
}

注意事项 #

• 使用late final时，必须保证变量在被使用前完成初始化，否则会触发运行时错误。
• 使用agentMap[key]!时，要确保对应的key存在于map中，或添加空值判断避免崩溃。

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