flutter基础04-Zone

在Dart中，Zone是一个非常核心但很多人忽略的机制。它主要用于：

• 拦截错误

• 控制异步行为

• 传递上下文

• 日志 / 监控 / 调试

简单理解：

Zone = Dart 的“异步上下文环境”。

它会包裹一段代码，并影响该代码以及其所有异步任务。

1 为什么需要 Zone

在普通代码里：

void main() {
Future(() {
throw Exception("error");
});
}

这个错误：

Uncaught Exception

可能不会被try-catch捕获，因为它在异步任务里。

这时候就需要Zone。

2 最常见用法：runZonedGuarded

import 'dart:async';

void main() {
runZonedGuarded(() {
Future(() {
throw Exception("error");
});
}, (error, stack) {
print("捕获到错误: $error");
});
}

输出：

捕获到错误: Exception: error

作用：

Zone 捕获整个异步链的错误

3 Zone 的基本概念

Zone 会形成一个树结构：

Root Zone
│
├─ Zone A
│ └─ async tasks
│
└─ Zone B
└─ async tasks

特点：

• 每个 Zone 有独立配置

• 子 Zone 会继承父 Zone

4 创建 Zone

最简单：

runZoned(() {
print("inside zone");
});

带配置：

runZoned(
() {
print("hello");
},
zoneValues: {
"userId": 123
},
);

5 Zone 传递上下文（非常重要）

runZoned(
() {
print(Zone.current["userId"]);
},
zoneValues: {
"userId": 123
},
);

输出：

123

即使在Future中：

runZoned(
() {
Future(() {
print(Zone.current["userId"]);
});
},
zoneValues: {
"userId": 123
},
);

仍然输出：

123

说明：

Zone 会自动传播到异步任务

6 拦截 print（高级）

Zone 可以拦截函数行为：

runZoned(
() {
print("hello");
},
zoneSpecification: ZoneSpecification(
print: (self, parent, zone, line) {
parent.print(zone, "LOG: $line");
},
),
);

输出：

LOG: hello

用途：

• 日志系统

• Debug 工具

• Flutter DevTools

7 Flutter 为什么用 Zone

在Flutter中，Zone 主要用于：

(1) 捕获所有异常

Flutter 的入口其实类似：

runZonedGuarded(() {
runApp(MyApp());
}, (error, stack) {
reportCrash(error);
});

(2) DevTools 调试

Dart DevTools
使用 Zone 追踪异步调用。

(3)Flutter error handler

FlutterError.onError

底层也和 Zone 配合。

8 Zone 和 Isolate 的关系

总结：

Isolate = 并发
Zone = 异步控制

9 实际项目常见用途

全局错误捕获

runZonedGuarded(() {
runApp(MyApp());
}, (error, stack) {
uploadCrash(error);
});

请求 TraceId

zoneValues: {"traceId": uuid}

统一日志

ZoneSpecification(print: ...)

✅一句话总结

Zone 是 Dart 用来管理异步执行环境、错误处理和上下文传递的机制。

如果你在学Flutter / Dart 并发体系，我可以给你讲一个更关键的知识：

Dart 的完整执行模型：

Event Loop
Microtask Queue
Future
Zone
Isolate

这套模型理解后，Flutter 卡顿 / async / Future / Isolate 的问题基本都能解释清楚。