Flutter 中的数据跨层传递方案

在 Flutter 中，数据跨层传递（从父组件向子组件传递数据，或从子组件向父组件传递）有多种方案，主要包括以下几种：

---

1. 直接参数传递（Constructor 参数）

适用场景：

• 父组件向子组件传递数据，适用于层级关系较浅的情况。

示例：

class ParentWidget extends StatelessWidget {
  final String message = "Hello from Parent";

  @override
  Widget build(BuildContext context) {
    return ChildWidget(message: message);
  }
}

class ChildWidget extends StatelessWidget {
  final String message;
  
  const ChildWidget({required this.message});

  @override
  Widget build(BuildContext context) {
    return Text(message);
  }
}

✅ 优点：简单、直观。
❌ 缺点：如果层级较深，可能需要逐层传递，导致“参数传递链”问题。

---

2. InheritedWidget（Flutter 低级状态管理方案）

适用场景：

• 子 Widget 跨层共享父 Widget 的属性，且数据不会频繁更新。

示例：

class MyDataProvider extends InheritedWidget {
  final String data;

  const MyDataProvider({required this.data, required Widget child}) : super(child: child);

  static MyDataProvider? of(BuildContext context) {
    return context.dependOnInheritedWidgetOfExactType<MyDataProvider>();
  }

  @override
  bool updateShouldNotify(covariant MyDataProvider oldWidget) {
    return oldWidget.data != data;
  }
}

class ParentWidget extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MyDataProvider(
      data: "Hello from InheritedWidget",
      child: ChildWidget(),
    );
  }
}

class ChildWidget extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    final provider = MyDataProvider.of(context);
    return Text(provider?.data ?? "No data");
  }
}

✅ 优点：数据可在组件树中被多个组件访问，无需手动传递。
❌ 缺点：手写较繁琐，通常与 ChangeNotifier 或 Provider 结合使用。

---

3. Provider（推荐）

适用场景：

• 全局状态管理，适用于多个页面共享数据的情况。

示例：

import 'package:flutter/material.dart';
import 'package:provider/provider.dart';

class CounterProvider with ChangeNotifier {
  int count = 0;

  void increment() {
    count++;
    notifyListeners();
  }
}

void main() {
  runApp(
    ChangeNotifierProvider(
      create: (_) => CounterProvider(),
      child: MyApp(),
    ),
  );
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: CounterPage(),
    );
  }
}

class CounterPage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text("Provider Example")),
      body: Column(
        mainAxisAlignment: MainAxisAlignment.center,
        children: [
          Text("Count: ${context.watch<CounterProvider>().count}"),
          ElevatedButton(
            onPressed: () {
              context.read<CounterProvider>().increment();
            },
            child: Text("Increment"),
          ),
        ],
      ),
    );
  }
}

✅ 优点：官方推荐、简洁、支持自动通知 UI 更新。
❌ 缺点：需要引入 provider 包。

---

4. Riverpod（增强版 Provider）

适用场景：

• 需要更强的依赖注入和状态管理能力，避免 Provider 的嵌套问题。

示例：

import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';

final counterProvider = StateProvider<int>((ref) => 0);

void main() {
  runApp(ProviderScope(child: MyApp()));
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: CounterPage(),
    );
  }
}

class CounterPage extends ConsumerWidget {
  @override
  Widget build(BuildContext context, WidgetRef ref) {
    final count = ref.watch(counterProvider);
    return Scaffold(
      appBar: AppBar(title: Text("Riverpod Example")),
      body: Column(
        mainAxisAlignment: MainAxisAlignment.center,
        children: [
          Text("Count: $count"),
          ElevatedButton(
            onPressed: () => ref.read(counterProvider.notifier).state++,
            child: Text("Increment"),
          ),
        ],
      ),
    );
  }
}

✅ 优点：比 Provider 更简洁、更强大，避免 context 依赖问题。
❌ 缺点：学习成本较高，需要使用 flutter_riverpod 包。

---

5. GetX（轻量级但强大的状态管理）

适用场景：

• 想要减少模板代码，并需要更高性能的状态管理。

示例：

import 'package:flutter/material.dart';
import 'package:get/get.dart';

class CounterController extends GetxController {
  var count = 0.obs;
  void increment() => count++;
}

void main() {
  runApp(GetMaterialApp(home: CounterPage()));
}

class CounterPage extends StatelessWidget {
  final CounterController controller = Get.put(CounterController());

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text("GetX Example")),
      body: Column(
        mainAxisAlignment: MainAxisAlignment.center,
        children: [
          Obx(() => Text("Count: ${controller.count}")),
          ElevatedButton(
            onPressed: controller.increment,
            child: Text("Increment"),
          ),
        ],
      ),
    );
  }
}

✅ 优点：无需 context，代码简洁，性能高。
❌ 缺点：非官方方案，项目可能不易维护。

---

6. EventBus（跨组件间事件通信）

适用场景：

• 非父子组件之间传递数据，比如 多个页面或多个独立的组件 之间通信。

示例：

import 'package:event_bus/event_bus.dart';

final EventBus eventBus = EventBus();

class DataEvent {
  final String data;
  DataEvent(this.data);
}

// 发送事件
eventBus.fire(DataEvent("Hello EventBus"));

// 监听事件
eventBus.on<DataEvent>().listen((event) {
  print(event.data);
});

✅ 优点：适合全局事件通信，避免组件嵌套传参。
❌ 缺点：管理不当可能导致事件滥用，影响代码可读性。

---

7. Notification（从子组件向父组件传递数据）

适用场景：

• 适用于 子组件向父组件发送事件通知，常用于 滚动监听、交互事件 等情况。

示例

子组件 发送 CustomNotification，父组件 监听 并接收通知：

import 'package:flutter/material.dart';

// 自定义通知类
class CustomNotification extends Notification {
  final String message;
  CustomNotification(this.message);
}

class NotificationExample extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text("Notification Example")),
      body: NotificationListener<CustomNotification>(
        onNotification: (notification) {
          ScaffoldMessenger.of(context).showSnackBar(
            SnackBar(content: Text("收到通知: ${notification.message}")),
          );
          return true; // 返回 true，表示已处理通知
        },
        child: ChildWidget(),
      ),
    );
  }
}

class ChildWidget extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Center(
      child: ElevatedButton(
        onPressed: () {
          CustomNotification("Hello, Parent!").dispatch(context);
        },
        child: Text("发送通知"),
      ),
    );
  }
}

void main() {
  runApp(MaterialApp(home: NotificationExample()));
}

解析

• NotificationListener<CustomNotification> 监听 子组件 ChildWidget 发送的 CustomNotification 事件。
• CustomNotification("Hello, Parent!").dispatch(context); 从子组件向上传递通知，并触发 onNotification 方法。
• ScaffoldMessenger.of(context).showSnackBar(...) 在父组件显示通知。

✅ 优点：

• 适合 从子组件向上 传递事件，而无需父组件主动监听或传递回调函数。
• 无需 Provider、全局状态，适用于简单的事件通知。

❌ 缺点：

• 不适合传递复杂数据（比如全局状态）。
• 仅能向上级组件传递，不能横向或全局广播数据。

---

使用场景

• 子组件通知父组件某些事件发生（如按钮点击、用户输入变化）。
• 监听滚动事件（ScrollNotification）。
• 监听输入框变化（FormField 自带 FormFieldState）。

---

总结

方案	方向	适用场景	优点	缺点
构造函数传参	父 → 子	普通数据传递	简单直观	层级深时麻烦
InheritedWidget	父 → 子	共享数据但不频繁变更	内置方案	代码较复杂
Provider ✅	全局	官方推荐，适合全局状态	易用高效	需要第三方库
Riverpod	全局	更强大的依赖管理	简单、无 context 限制	学习成本
GetX	全局	轻量级状态管理	代码简洁，性能好	非官方方案
EventBus	任意	跨组件通信	适合全局事件	可能滥用
Notification	子 → 父	子组件通知父组件	无需回调，适合单向事件	仅支持向上传递

✅ 结论：

• 状态管理：推荐 Provider / Riverpod。
• 子 → 父传递：Notification（事件通知），或者直接 回调（Function）。
• 轻量级方案：GetX（简洁），或者 直接 StatefulWidget 维护本地状态。