Flutter 事件总线

封面图 • 2025-11-05 • Flutter

在 Flutter 中，**事件总线（Event Bus）** 是一种用于组件间通信的机制，特别是在跨层级、非父子关系的组件之间传递消息时非常有用。Flutter 本身没有内置的事件总线，但可以通过第三方库（如 `rxdart` 或 `event_bus`）来实现。

---

## ✅ 常见的 Flutter 事件总线实现方式

### 1. 使用 `event_bus` 库（推荐）

这是一个轻量级的事件总线库，使用简单，适合大多数场景。

#### 步骤：

#### 1. 添加依赖
在 `pubspec.yaml` 中添加：

```yaml
dependencies:
  event_bus: ^2.0.0
```

#### 2. 创建事件类

```dart
class MyEvent {
  final String message;

MyEvent(this.message);
}
```

#### 3. 创建事件总线实例

```dart
import 'package:event_bus/event_bus.dart';

final eventBus = EventBus();
```

#### 4. 发布事件

```dart
eventBus.fire(MyEvent("Hello from event bus!"));
```

#### 5. 订阅事件

```dart
eventBus.on<MyEvent>().listen((event) {
  print(event.message); // 输出: Hello from event bus!
});
```

> 注意：在 Flutter 中，建议将事件监听器放在 `initState()` 中，并在 `dispose()` 中取消订阅，避免内存泄漏。

```dart
@override
void initState() {
  super.initState();
  _subscription = eventBus.on<MyEvent>().listen((event) {
    print(event.message);
  });
}

@override
void dispose() {
  _subscription.cancel();
  super.dispose();
}
```

---

### 2. 使用 `rxdart` 实现事件总线

如果你已经在项目中使用了 `rxdart`，可以使用 `BehaviorSubject` 来模拟事件总线。

#### 示例代码：

```dart
import 'package:rxdart/rxdart.dart';

// 创建一个行为主题
final eventSubject = BehaviorSubject<String>();

// 发送事件
eventSubject.add("Hello from rxdart event bus!");

// 接收事件
eventSubject.listen((message) {
  print(message);
});
```

> 这种方式更灵活，也支持各种操作符（如 `map`, `filter`, `debounce` 等），适合需要复杂逻辑的场景。

---

## 📌 事件总线的适用场景

- 跨组件通信（如：页面 A 发送事件，页面 B 接收）
- 导航栈之间的通信
- 消息通知（如：网络状态变化、用户登录/登出等）

---

## ⚠️ 注意事项

- **不要滥用事件总线**，容易造成代码难以维护。
- 如果只是父子组件之间通信，优先使用 `Navigator`、`Provider`、`Stream` 或 `Function` 回调。
- 在 Flutter 中，`Provider` + `ChangeNotifier` 是更现代、结构清晰的替代方案。

---

## 🧩 总结

| 方案         | 是否推荐 | 特点                             |
|--------------|----------|----------------------------------|
| `event_bus`  | ✅       | 简单易用，适合大多数场景         |
| `rxdart`     | ✅       | 功能强大，适合复杂事件处理       |
| `Provider`   | ✅       | 更符合 Flutter 的状态管理理念    |
| `Stream`     | ✅       | 内置支持，适合数据流通信         |

---

如果你有具体的使用场景（比如：页面间通信、全局状态更新等），我可以帮你选择最适合的方案。需要我给你写一个完整的示例吗？