在 Flutter 中，StatefulWidget 的生命周期实际上是由其关联的 State<T> 对象管理的。掌握这些生命周期方法对于正确初始化资源、响应状态变化、避免内存泄漏以及优化渲染性能至关重要。

以下是 StatefulWidget 的完整生命周期解析：

🔁 核心生命周期方法（按典型调用顺序）

📊 典型调用时序

首次创建：
createState() → initState() → didChangeDependencies() → build()

状态更新（开发者触发）：
setState() → build()

父级重建 / 属性变化：
didUpdateWidget() → build()

依赖的 InheritedWidget 变化：
didChangeDependencies() → build()

组件从树中移除：
deactivate() → dispose()

💡 注意：deactivate() 和 dispose() 的区别在于，deactivate() 移除后可能被重新插入树中（如页面切换、GlobalKey 复用），而 dispose() 是永久销毁。

⚠️ 关键注意事项 & 最佳实践

1. initState 中不能直接调用 setState()
   此时 Widget 树尚未完全建立，调用会抛异常。如需首帧后更新状态，可使用：

   WidgetsBinding.instance.addPostFrameCallback((_) {
     setState(() { /* ... */ });
   });
   

2. 善用 mounted 属性
   在异步操作回调中调用 setState 前，务必检查 if (mounted)，避免组件已销毁后仍尝试更新状态。

3. build() 必须是纯函数
   不应包含副作用（如网络请求、打印日志、修改状态）。只做 UI 描述，保持快速可重复执行。

4. didChangeDependencies() 的陷阱
   它会在 initState 后立即调用一次，之后每次依赖变化都会触发。避免在此做耗时操作或重复初始化逻辑。

5. didUpdateWidget() 用于属性同步
   当父组件重建并传入新参数时调用，适合对比 widget.xxx 与 oldWidget.xxx 的差异并更新内部状态。

6. dispose() 必须彻底清理
   忘记释放 AnimationController、StreamSubscription、Timer、FocusNode 等是内存泄漏的常见原因。

7. deactivate() 日常开发极少重写
   除非你在实现复杂的 Widget 复用逻辑或自定义路由过渡，否则保持默认即可。

📝 代码结构示例

class MyStatefulWidget extends StatefulWidget {
  const MyStatefulWidget({super.key, required this.title});
  final String title;

  @override
  State<MyStatefulWidget> createState() => _MyStatefulWidgetState();
}

class _MyStatefulWidgetState extends State<MyStatefulWidget> {
  int _counter = 0;

  @override
  void initState() {
    super.initState();
    // 1. 初始化
  }

  @override
  void didChangeDependencies() {
    super.didChangeDependencies();
    // 2. 依赖变化时响应
  }

  @override
  void didUpdateWidget(MyStatefulWidget oldWidget) {
    super.didUpdateWidget(oldWidget);
    // 3. 属性变化时同步
  }

  @override
  Widget build(BuildContext context) {
    // 4. 构建 UI
    return Text('${widget.title}: $_counter');
  }

  @override
  void dispose() {
    // 5. 清理资源
    super.dispose();
  }
}

✅ 总结口诀

初始化在 initState，依赖响应在 didChangeDependencies，
属性同步看 didUpdateWidget，UI 构建交给 build，
状态更新用 setState，资源释放进 dispose。