关于StatefulWidget.build文档、缓存策略及Builder组件的问询

一、缓存子树的正确写法 #

直接结论：应该用 final Widget widget = MyWidget();，绝对不要调用 .build(context)。

Flutter里的Widget本质是不可变的UI配置信息，框架会自动负责Widget的build调用、Element树的维护以及RenderObject的渲染。手动调用build(context)会绕过框架的生命周期管理，导致上下文不匹配、状态丢失、无法参与Flutter的diff优化等问题，完全违背了Flutter的设计逻辑。

二、两种写法的核心区别 #

• MyWidget()：创建的是完整的Widget实例，它只是一份UI配置，不会立即生成实际的渲染节点。Flutter框架会在合适的时机（首次渲染、状态变化、依赖更新时）自动调用它的build方法，生成对应的Element和RenderObject，整个流程严格遵循Flutter的Widget-Element-RenderObject三层架构，能享受到框架的性能优化（比如Widget复用、diff对比）。
• MyWidget().build(context)：直接调用build得到的是该Widget返回的子Widget片段，但这个操作完全跳过了Element的创建和管理流程。它相当于手动生成了一个临时的UI片段，无法和当前组件树的生命周期、状态绑定；一旦父组件重建，这个片段会被重新生成（因为缓存的是build结果，而build依赖的context可能变化），不仅起不到缓存优化的作用，还可能引发各种异常。

三、Builder组件与build方法的差异和用途 #

本质区别

• State的build方法：是StatefulWidget生命周期的核心部分，由Flutter框架自动触发调用（比如状态变化、父组件重建、依赖更新时），作用是返回当前状态对应的完整UI树，它的context是当前State所属Element的上下文，范围覆盖整个StatefulWidget。
• Builder组件：是一个专门的Widget，它的核心是提供一个局部的BuildContext，并通过builder回调延迟构建子Widget。回调里的context是Builder自身Element的上下文，范围只覆盖Builder包裹的区域。

各自用途

• State的build方法：是StatefulWidget必须实现的方法，用来描述状态变化后的UI结构，处理状态与UI的绑定，是组件更新UI的唯一入口。
• Builder组件：
  • 解决上下文查找问题：比如在Scaffold的body中直接用父级context调用Scaffold.of(context)会失败，用Builder包裹后，回调里的context是Builder的上下文，能正确找到Scaffold的状态。
  • 隔离构建范围：当某个子Widget的构建依赖父组件的动态参数，但不想让整个父组件重建时，用Builder可以只触发局部子树的构建，提升性能。
  • 复用构建逻辑：把重复的UI构建逻辑封装到Builder的回调中，在多个地方复用，减少代码冗余。

内容的提问来源于stack exchange，提问作者gitman-2021