Flutter - InheritedWidget

InheritedWidget 是 Flutter 中一种特殊的 Widget，核心作用是 在 Widget 树中高效地共享数据 ，尤其是当数据需要被多个层级较深的子 Widget 访问时。它是 Flutter 内置的「数据传递基础设施」，很多状态管理方案（如 Provider）和系统功能（如 Theme、MediaQuery）都基于它实现。

一、为什么需要 InheritedWidget？

在 Flutter 中，Widget 以树状结构组织，数据默认通过「父 Widget 向子 Widget 构造函数传参」的方式传递（即「单向数据流」）。但如果需要传递的数据要被 深层嵌套的子 Widget 使用（比如嵌套 5 层、10 层的子 Widget），这种「层层传参」的方式会非常繁琐，且难以维护。

InheritedWidget 解决了这个问题：它允许数据在 Widget 树的某个节点「注册」，之后 任意层级的子 Widget 都能直接获取该数据，无需手动层层传递。

二、核心原理：依赖与通知

InheritedWidget 的工作机制基于两个关键点：

依赖注册 ：子 Widget 通过特定方法（如 of）获取 InheritedWidget 中的数据时，会自动「注册依赖」，表示自己依赖该数据。
变化通知 ：当 InheritedWidget 中的数据发生变化时，会通过 updateShouldNotify 方法判断是否需要通知依赖它的子 Widget；若需要，所有依赖的子 Widget 会被标记为「需要重建」，从而更新 UI。

三、使用步骤（自定义 InheritedWidget）

下面通过一个简单例子，说明如何自定义 InheritedWidget 共享数据（以「用户信息」为例）。

在 Widget 树中共享「用户信息」数据，让深层嵌套的子 Widget 能直接获取这些数据，并且当数据更新时，依赖这些数据的子 Widget 能自动刷新。

假设我们有一个页面，需要展示用户的「姓名」和「年龄」，并且有一个按钮可以让年龄 + 1。这个用户信息可能被多个深层嵌套的子 Widget 使用（比如页面底部的子 Widget、列表项中的子 Widget 等）。如果用传统的「父传子」参数传递，嵌套层级深的话会很繁琐。我们用InheritedWidget来解决这个问题：让用户信息在 Widget 树的某个节点「注册」，所有子 Widget 直接获取，数据更新时自动同步。

1. 定义数据类

首先定义需要共享的数据结构（如用户信息）：首先需要一个数据类，用来存储要共享的数据（这里是用户的姓名和年龄）。

作用：这是我们要共享的数据载体，就像一个装着用户信息的「数据包」。

dart 复制代码

class User {
  final String name;
  final int age;
 // 构造函数：必须传入姓名和年龄
  User({required this.name, required this.age});
}

2. 实现 InheritedWidget 子类

继承 InheritedWidget，并实现两个核心方法：

InheritedWidget是抽象类，我们需要继承它并实现自己的逻辑，核心是「提供数据」和「通知更新」。

of：提供给子 Widget 获取当前 InheritedWidget 实例的静态方法。
updateShouldNotify：判断数据变化时是否需要通知依赖的子 Widget。

scala 复制代码

class UserInheritedWidget extends InheritedWidget {
  // 1. 要共享的数据（从外部传入）
  final User user;
   // 2. 用于更新数据的回调（外部可以通过它修改数据）
  final Function(User) onUpdateUser;

  // 3. 构造函数：必须传入child（子Widget树），以及要共享的数据和更新回调
  const UserInheritedWidget({
    super.key,
    required this.user,
    required this.onUpdateUser,
    required super.child,// 子Widget树（所有子Widget都能获取这里的user数据）
  });

  // 4. 静态方法：供子Widget获取当前InheritedWidget实例（核心！）
  static UserInheritedWidget of(BuildContext context) {
     // 从context中查找最近的UserInheritedWidget祖先
    final widget = context.dependOnInheritedWidgetOfExactType<UserInheritedWidget>();
    if (widget == null) {
      throw Exception("UserInheritedWidget not found in context");
    }
    return widget;
  }

  // 5. 判断数据变化时是否需要通知依赖的子Widget
  @override
  bool updateShouldNotify(covariant UserInheritedWidget oldWidget) {
    // 当新的user和旧的user数据不同时，返回true（需要通知子Widget更新）
    return user.name != oldWidget.user.name || user.age != oldWidget.user.age;
  }
}

关键部分解释：

user：存储要共享的用户数据，由父 Widget 传入。
onUpdateUser：一个回调函数，允许外部（比如管理状态的父 Widget）修改user数据。
of(context)：子 Widget 通过这个方法获取UserInheritedWidget实例，进而拿到user数据。调用这个方法时，子 Widget 会自动「注册依赖」------ 告诉UserInheritedWidget：「我依赖你的数据，变化时通知我」。
updateShouldNotify：当UserInheritedWidget重建时（比如数据更新），Flutter 会调用这个方法，比较新旧数据。如果返回true，所有通过of(context)注册过依赖的子 Widget 会被强制重建，刷新 UI。

将 UserInheritedWidget 作为父节点插入 Widget 树，使其子树中的所有 Widget 都能访问共享数据：

InheritedWidget本身是「不可变的」（Widget 都是不可变的），它的数据无法自己修改。因此需要一个「状态管理者」来保存和更新数据，这里用StatefulWidget的State来实现。

scala 复制代码

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

class _ParentWidgetState extends State<ParentWidget> {
   // 1. 实际存储数据的地方（状态保存在State中）
  User _user = User(name: "张三", age: 20);

  // 2. 更新数据的方法（点击按钮时调用）
  void _updateUser() {
    setState(() {
     // 创建新的User实例（因为User是不可变的，必须重新创建）
      _user = User(name: "张三", age: 21); // 年龄+1
    });
  }

  @override
  Widget build(BuildContext context) {
    return UserInheritedWidget(
      // 3. 将当前数据传给InheritedWidget
      user: _user,
      // 4. 传递更新数据的回调（InheritedWidget的子Widget可以通过它修改数据）
      onUpdateUser: (newUser) {
        setState(() => _user = newUser);// 接收新数据并更新状态
      },
      // 5. 子Widget树（这里包含需要使用user数据的ChildWidget）
      child: Column(
        children: [
          // 深层子Widget（不需要手动传user参数，直接通过InheritedWidget获取）
          ChildWidget(),
          // 按钮：点击触发年龄更新
          ElevatedButton(onPressed: _updateUser, child: Text("更新年龄")),
        ],
      ),
    );
  }
}

作用：

_user是真正的数据源头，保存在State中，确保数据能被修改（State是可变的）。
_updateUser方法通过setState修改_user（年龄 + 1），触发ParentWidget重建。
重建时，UserInheritedWidget会接收新的_user数据，完成数据更新。

任意层级的子 Widget 可通过 UserInheritedWidget.of(context) 直接获取数据：

scala 复制代码

class ChildWidget extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    // 获取共享的用户数据（自动注册依赖）
    final user = UserInheritedWidget.of(context).user;

    return Text("姓名：${user.name}，年龄：${user.age}");
  }
}

当点击「更新年龄」按钮时，ParentWidget 的 setState 会重建 UserInheritedWidget 并传入新数据；updateShouldNotify 返回 true，触发 ChildWidget 重建，显示更新后的年龄。

四、Flutter 内置的 InheritedWidget

Flutter 框架内部大量使用 InheritedWidget 共享全局数据，例如：

Theme：共享应用主题（颜色、字体等），子 Widget 通过 Theme.of(context) 获取。
MediaQuery：共享设备信息（屏幕尺寸、像素密度等），子 Widget 通过 MediaQuery.of(context) 获取。
Localizations：共享本地化文本，子 Widget 通过 Localizations.of(context) 获取。

五、核心特点总结

数据共享：解决 Widget 树深层数据传递问题，避免层层传参。
高效更新：仅通知依赖数据的子 Widget 重建，而非整个 Widget 树，性能更优。
单向依赖：数据只能从父 Widget 向子 Widget 传递（从上到下），符合 Flutter 单向数据流设计。
状态无关 ：InheritedWidget 本身仅负责「传递数据」，不管理数据变化（数据变化通常由 StatefulWidget 的 State 管理）。

六、和 Android 的类比

对于 Android 开发者，可以简单理解：

InheritedWidget 类似 Android 中的「全局变量」或「依赖注入容器」，但更安全（只在 Widget 树范围内共享）且更高效（精准通知更新）。

例如，Theme.of(context) 类似 Android 中 Context.getTheme()，但 InheritedWidget 是基于 Widget 树的动态共享，而 Android 的 Context 是基于组件生命周期的静态关联。

总之，InheritedWidget 是 Flutter 数据共享的底层核心，理解它能帮助你更好地掌握 Provider 等状态管理库的原理，以及 Flutter 框架的设计思想。

Flutter - InheritedWidget

一、为什么需要 InheritedWidget？

二、核心原理：依赖与通知

三、使用步骤（自定义 InheritedWidget）

1. 定义数据类

2. 实现 InheritedWidget 子类

3. 在 Widget 树中插入 InheritedWidget

4. 子 Widget 获取共享数据

四、Flutter 内置的 InheritedWidget

五、核心特点总结

六、和 Android 的类比