NavigatorObserver / RouteObserver 在路由层统一处理

✅ 方案一（强烈推荐）：全局 NavigatorObserver（最干净）

原理一句话

只要发生 pop（返回），统一调用：

FocusManager.instance.primaryFocus?.unfocus();

1️⃣ 定义一个全局 Observer

class UnfocusOnPopObserver extends NavigatorObserver {
void _unfocus() {
FocusManager.instance.primaryFocus?.unfocus();
}

@override
void didPop(Route route, Route? previousRoute) {
_unfocus();
super.didPop(route, previousRoute);
}

@override
void didPush(Route route, Route? previousRoute) {
// 可选：push 时也 unfocus（防止闪键盘）
_unfocus();
super.didPush(route, previousRoute);
}

@override
void didReplace({Route? newRoute, Route? oldRoute}) {
_unfocus();
super.didReplace(newRoute: newRoute, oldRoute: oldRoute);
}
}

2️⃣ 在 MaterialApp 里注册（关键）

MaterialApp(
navigatorObservers: [
UnfocusOnPopObserver(),
],
home: const HomePage(),
);

🎉 效果

• ✅ 所有 Navigator.push / pop / replace
• ✅ 所有页面
• ✅ 所有 TextField
• ✅ 包括你这个 TestHome

完全不用改你写的任何页面代码

🧠 为什么这是「最佳实践」

👉 键盘是全局 UI 状态，就应该在路由层处理

✅ 方案二：RouteObserver + 页面混入（适合精细控制）

如果你希望：

• 只有部分页面
• 或只在 didPopNext（返回到该页面）时 unfocus

1️⃣ 定义 RouteObserver

final RouteObserver<PageRoute> routeObserver =
RouteObserver<PageRoute>();

注册：

MaterialApp(
navigatorObservers: [routeObserver],
);

2️⃣ 页面里监听「返回到当前页面」

class _HomeState extends State<Home>
with RouteAware {

@override
void didChangeDependencies() {
super.didChangeDependencies();
routeObserver.subscribe(
this,
ModalRoute.of(context)! as PageRoute,
);
}

@override
void didPopNext() {
FocusManager.instance.primaryFocus?.unfocus();
}

@override
void dispose() {
routeObserver.unsubscribe(this);
super.dispose();
}
}

📌 适合：

• 聊天页
• 搜索页
• 编辑页

但不如方案一简单统一

🟡 方案三（兜底）：全局 WidgetsBindingObserver

class GlobalUnfocusObserver with WidgetsBindingObserver {
@override
void didChangeAppLifecycleState(AppLifecycleState state) {
if (state == AppLifecycleState.resumed) {
FocusManager.instance.primaryFocus?.unfocus();
}
}
}

📌 只能处理：

• 后台 → 前台
• 不是真正的路由 pop

⚠️ 不推荐作为主方案

🧩 回到你的例子（TestHome）

你原来的代码：

await Navigator.of(context).push(
MaterialPageRoute(builder: (_) => TestHome()),
);

👉 完全不用改

只要在 MaterialApp 里加：

navigatorObservers: [
UnfocusOnPopObserver(),
],

你现在的行为会变成：

1. TextField 有光标
2. push 到 TestHome
3. pop 返回
4. 🔥 键盘不弹，光标消失

🧠 一句话总结（建议你记住）

键盘 / Focus 是全局状态
路由切换是全局事件
👉 用 NavigatorObserver 统一处理

🚀 如果你愿意继续进阶

我可以帮你：

• 🔹 做一个 AppNavigatorObserver（顺带统计路由）
• 🔹 适配 GoRouter / AutoRoute
• 🔹 处理 Android 13 predictive back
• 🔹 Drawer / BottomSheet / Dialog 全覆盖

直接告诉我你用的是哪套路由（Navigator 1.0 / GoRouter）即可。