在 Flutter 里做双层 PageView 时，最常见的体验问题不是“滑不动”，而是滑动关系断掉：用户已经滑到内层第一页，再继续向右拖，外层却不会顺势切回上一页。本文不走复杂的手势竞争方案，而是直接利用滚动通知判断边界状态、滑动方向和触发层级，给出一套代码量很小、但足够实用的处理方式，同时说明它为什么在 iOS 上还需要额外设置 physics。
问题场景与页面结构
嵌套关系是什么样
页面结构可以概括为两层横向分页：
- 外层是
PageView1，包含两个页面：PV1-View1和PV1-View2。 PV1-View2内部又嵌套了一个PageView2。- 内层
PageView2同样包含两个页面：PV2-View1和PV2-View2。
也就是说，用户先在外层分页间切换，进入 PV1-View2 后，再继续操作内层分页。
实际卡顿点出在哪
问题集中出现在这个场景：
- 先把
PageView1滑动到PV1-View2。 - 再把
PageView2停在PV2-View1。 - 此时用户继续对
PV2-View1向右 滑动。
按直觉，这一步应该自然回到外层的 PV1-View1；但默认情况下，页面并不会自动切换，导致交互链路中断。
期望的交互效果
更合理的体验应该是：
- 当内层已经位于第一页
PV2-View1时，继续向右滑，可以直接切回外层的PV1-View1。 - 之后用户再向左滑，又能重新进入
PV1-View2，并继续操作其中的PageView2。
换句话说，目标不是解决“谁响应手势”，而是让边界滑动在内外两层分页之间自然衔接。
解决思路：监听越界滑动并主动切页
为什么选 `NotificationListener`
这里不必上复杂的手势竞争管理。更直接的方法，是用 NotificationListener 包住外层 PageView1，统一监听外层和内层滚动过程里抛出的通知。
核心原因在于：当用户把某个 PageView 拖到边界还继续滑动时，会触发 OverscrollNotification。只要拿到这个通知，就能知道当前是不是“滑到头了还在继续拖”，这正是我们需要的时机。
判断逻辑依赖哪几个属性
处理逻辑主要看 OverscrollNotification 里的几个字段：
depth：区分当前通知来自哪一层滚动视图，用它判断是外层PageView1还是内层PageView2。overscroll：判断越界滑动方向。文中结论是：overscroll > 0表示向左滑动，overscroll < 0表示向右滑动。velocity：辅助判断当前是否是符合预期的边界拖动状态。示例代码里用velocity == 0作为触发条件之一。
因此，整套判断可以收敛成一句话：当监听到内层分页在第一页继续向右越界滑动时，主动让外层 PageView1 切回第 0 页。
实现步骤可简化为 4 步
- 使用
NotificationListener包裹PageView1。 - 在
onNotification中接收OverscrollNotification。 - 通过
depth判断当前越界的是内层PageView2。 - 当
overscroll < 0且满足示例中的速度条件时，调用外层控制器的animateToPage(0)。
为什么还要处理 `physics` 差异
Android 和 iOS 默认行为不同
PageView 的 physics 在不同平台默认值并不一致：
- Android：默认是
ClampingScrollPhysics。 - iOS：默认是
BouncingScrollPhysics。
这会直接影响越界滚动通知的表现。
为什么内层要改成 `ClampingScrollPhysics`
本文方案依赖“边界之外的滑动通知”来接管切页逻辑，因此内外层在越界行为上最好保持一致。原文给出的处理是：把 PageView2 的 physics 显式改成 ClampingScrollPhysics。
这样做的目的不是单纯改手感，而是为了让 iOS 侧也按同一套边界判断逻辑工作，避免平台差异导致监听条件失效或表现不一致。
涉及到的 Flutter 知识点
`NotificationListener` 是怎么用的
在 Flutter 中，NotificationListener 用来监听并处理滚动通知，比如滚动开始、结束、位置变化，以及本文关心的越界滚动。它常和 ListView、GridView、SingleChildScrollView、PageView 这类滚动组件一起使用。
原文中的类定义如下：
class NotificationListener<T extends Notification> extends ProxyWidget {
/// Creates a widget that listens for notifications.
const NotificationListener({
super.key,
required super.child,
this.onNotification,
});
final NotificationListenerCallback<T>? onNotification;
@override
Element createElement() {
return _NotificationElement<T>(this);
}
}
对本文来说，重点只有一个：通过 onNotification 拿到滚动通知，然后在这里做条件判断。
`OverscrollNotification` 里最关键的字段
OverscrollNotification 会在滚动超出边界时触发。原文给出的类代码如下：
class OverscrollNotification extends ScrollNotification {
OverscrollNotification({
required super.metrics,
required BuildContext super.context,
this.dragDetails,
required this.overscroll,
this.velocity = 0.0,
}) : assert(overscroll.isFinite),
assert(overscroll != 0.0);
// 如果 Scrollable 因拖动而过度滚动，则有关该拖动的详细信息将更新。
final DragUpdateDetails? dragDetails;
// Scrollable 过度滚动的逻辑像素数。
final double overscroll;
// 发生过度滚动时 ScrollPosition 变化的速度。
final double velocity;
}
结合本文场景，可以把几个字段理解得更直接一些：
dragDetails：只有发生越界拖动时，这个信息才会更新，默认可能是Null。overscroll：越界的像素值；开始侧为负，结束侧为正。velocity：越界时ScrollPosition的变化速度。depth：通知已经冒泡过几个视口，可用来区分当前触发的是哪一层PageView。
`ClampingScrollPhysics` 在这里的作用
ClampingScrollPhysics 是 Flutter 中一种限制滚动范围的物理模型，常用于 PageView 等滚动组件。放在本文场景下，它的价值主要有两点：
- 让内层分页的边界行为更稳定，便于监听越界通知。
- 统一 Android 与 iOS 的处理方式，减少平台差异带来的额外分支。
可直接参考的代码写法
原文示例代码如下，核心逻辑已经足够清晰：
/// PageView1 视图
NotificationListener<OverscrollNotification>(
onNotification: (notification) {
if (notification.depth == 1 && notification.overscroll < 0 && notification.velocity == 0) {
_pageController.animateToPage(0, duration: Duration(milliseconds: 200), curve: Curves.linear);
return false;
}
return true;
},
child: PageView.builder(
controller: _pageController,
... // 省略无用代码
).expanded(),
),
/// PageView2 的视图
PageView.builder(
physics: const ClampingScrollPhysics(),
...// 省略无用代码
）
这段代码该怎么读
notification.depth == 1：说明当前监听到的是内层PageView2的越界通知，而不是外层本身。notification.overscroll < 0：表示当前是继续向右滑动，符合“从内层第一页回退到外层上一页”的方向。notification.velocity == 0：作为额外限制条件，用来收窄触发时机。animateToPage(0)：满足条件后，直接把外层PageView1切换回第0页。Duration(milliseconds: 200)：切页动画时间为200毫秒。curve: Curves.linear：使用线性动画曲线。
如果你的页面结构和本文一致，这段逻辑基本就是最小可用版本。
总结
Flutter 里双层 PageView 的滑动不连贯，很多时候并不需要从手势冲突系统下手。只要抓住“内层已经到边界、用户仍在继续拖动”这个时机，用 NotificationListener 监听 OverscrollNotification，再结合 depth、overscroll、velocity 做判断，就能把内外层分页自然串起来。
实际落地时，别忽略平台差异：如果希望 iOS 侧也按同样逻辑工作，记得把内层 PageView2 的 physics 调整为 ClampingScrollPhysics。
