如何将Widget参数用作变量？Flutter报‘widget未定义’错误

错误原因 #

在State类的成员变量直接初始化阶段，State对象还未与对应的Widget完成绑定，此时widget属性还未被初始化，直接用widget.currentPageForRoute赋值会触发报错。

解决方案 #

方法1：使用late延迟初始化 #

先声明变量时用late修饰，再在initState方法中完成赋值（此时widget已可用）：

class HomePage extends StatefulWidget {
  final UserState userState;
  final int currentPageForRoute;

  const HomePage({
    super.key,
    required this.userState,
    required this.currentPageForRoute,
  });

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

class _HomePageState extends State<HomePage> {
  late int currentPage; // 用late标记延迟初始化

  @override
  void initState() {
    super.initState();
    currentPage = widget.currentPageForRoute;
  }

  // 后续可正常修改currentPage
  void changePage(int newPage) {
    setState(() {
      currentPage = newPage;
    });
  }

  @override
  Widget build(BuildContext context) {
    // ... 你的UI代码
    return Container();
  }
}

方法2：使用可空类型初始化 #

如果不想用late，可以将变量声明为可空类型，在initState中完成赋值：

class _HomePageState extends State<HomePage> {
  int? currentPage; // 声明为可空类型

  @override
  void initState() {
    super.initState();
    currentPage = widget.currentPageForRoute;
  }

  // 使用时注意处理空值，或确保变量不会为空
  @override
  Widget build(BuildContext context) {
    return Text("当前页面：${currentPage ?? 0}");
  }
}

额外处理：Widget参数更新的情况 #

如果父组件会更新HomePage的currentPageForRoute参数，需要在didUpdateWidget方法中同步更新currentPage，避免数据不一致：

@override
void didUpdateWidget(covariant HomePage oldWidget) {
  super.didUpdateWidget(oldWidget);
  if (oldWidget.currentPageForRoute != widget.currentPageForRoute) {
    setState(() {
      currentPage = widget.currentPageForRoute;
    });
  }
}

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