Flutter中Widget仅实例化一次时build方法可多次调用？变量声明位置探析

一、是否存在仅调用build而不触发Widget构造的场景？ #

答案是肯定的，Flutter的Widget树复用机制会让StatelessWidget在很多情况下只实例化一次，但build方法被多次调用，常见场景包括：

• 父Widget因状态变化重建，但传递给当前StatelessWidget的参数未发生改变，Flutter会复用现有Widget实例，仅触发build。
• 依赖的InheritedWidget（如Theme、MediaQuery、Provider中的状态）更新时，会触发依赖它的Widget的build，但不会重新创建Widget实例。
• 屏幕旋转、窗口大小调整等设备配置变更，也可能触发build而不重建Widget。

你之前没观测到这种情况，大概率是测试场景太简单——可以试试下面的示例代码，就能看到构造只执行一次、build多次执行的现象。

二、除可读性外，build外声明变量的优势 #

1. 避免重复初始化，提升性能
   如果变量需要复杂计算（比如解析JSON、创建复杂对象），放在成员变量里只会在Widget实例化时执行一次；而放在build内，每次build都会重新计算/创建，造成不必要的性能消耗。哪怕是示例里的固定值1000，如果后续改成依赖构造参数的计算值（比如final int milliseconds = widget.duration * 1000），成员变量的优势会更明显。

2. 保持值的一致性
   成员变量在Widget生命周期内是固定的（因为StatelessWidget不可变），能确保整个Widget的build输出始终基于同一个值；而如果在build内不小心引入了上下文的临时变量，可能导致每次build的结果不一致（虽然StatelessWidget应该避免这种情况，但成员变量的写法更安全）。

3. 提升代码复用性
   如果多个子Widget需要用到同一个变量，成员变量可以直接引用，不用在build内重复定义，减少冗余代码。

4. 便于测试
   成员变量可以在单元测试中直接访问或修改，而build内的临时变量只能通过Widget的输出间接验证，测试成本更高。

三、两种写法的适用场景 #

• 放在build外（成员变量）：固定常量、依赖构造参数的计算值、需要在多个地方复用的值。
• 放在build内（临时变量）：仅在build过程中使用的临时参数（比如创建子Widget时的临时配置），避免污染类的命名空间。

测试示例代码 #

class ParentWidget extends StatefulWidget {
  @override
  State<ParentWidget> createState() => _ParentWidgetState();
}

class _ParentWidgetState extends State<ParentWidget> {
  int _counter = 0;

  @override
  Widget build(BuildContext context) {
    return Column(
      children: [
        ElevatedButton(
          onPressed: () => setState(() => _counter++),
          child: Text('点击次数: $_counter'),
        ),
        // 传递固定参数，父重建时子Widget实例复用
        const Something(milliseconds: 1000),
      ],
    );
  }
}

class Something extends StatelessWidget {
  final int milliseconds;

  const Something({super.key, required this.milliseconds}) {
    print('Something构造函数被调用');
  }

  @override
  Widget build(BuildContext context) {
    print('Something build被调用');
    return Text('毫秒数: $milliseconds');
  }
}

点击按钮时，控制台会多次打印Something build被调用，但Something构造函数被调用只会打印一次，完美复现你要找的场景。

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