pages.json 中配置 popGesture 是 iOS 侧滑返回的唯一可靠入口，仅支持 "close" 和 "none"；安卓设 "none" 会同时禁用物理返回键，需手动监听 backbutton 并调用 uni.navigateBack()。
pages.json 里配 popGesture 是唯一可靠入口
iOS 侧滑返回是系统级行为，JS 层根本收不到事件，onBackPress 对它完全无效。想控制，必须在原生层关掉手势，把控制权拿回来。pages.json 就是 uni-app 提供的、且唯一稳定的配置入口。
实测有效值只有两个："close" 和 "none"：
-
"close"：iOS 侧滑时直接关闭当前 webview（等效于调用uni.navigateBack()或plus.webview.currentWebview().close()），安卓下表现接近默认行为 -
"none"：彻底禁用侧滑手势，但注意——安卓设成这个后，物理返回键也会失效，必须额外监听plus.key.addEventListener('backbutton')
配置位置必须在页面级 style 下，不能只写在全局 globalStyle 里，否则已加载的页面不会动态生效：
{
"path": "pages/detail/detail",
"style": {
"popGesture": "close"
}
}
安卓设 popGesture: "none" 后物理键也失效怎么办
这是最常踩的坑：以为关了侧滑就完事了，结果用户按返回键没反应。因为 popGesture: "none" 在安卓上会一并禁用所有返回通道，包括物理键和虚拟导航栏按钮。
必须手动补监听，并在回调里显式调用 uni.navigateBack() 或业务逻辑：
- 要用
// #ifdef APP-PLUS包裹，避免 H5 / 小程序报错 - 监听需在
onLoad或onShow中注册，不能延迟到mounted - 记得在页面卸载前用
plus.key.removeEventListener清理，防内存泄漏
示例：
// #ifdef APP-PLUS
plus.key.addEventListener('backbutton', () => {
uni.navigateBack();
});
// #endif
iOS 弹窗场景需运行时开关 popGesture
配置文件只能控制页面初始状态。比如你从详情页弹出一个全屏弹窗，此时必须禁用侧滑，否则用户左滑会直接退出详情页而非关闭弹窗；弹窗关闭后，又得立刻恢复侧滑，否则后续返回操作异常。
运行时开关靠 this.$mp.page.$getAppWebview().setStyle()：
- 获取实例必须用
this.$mp.page.$getAppWebview()，plus.webview.currentWebview()在某些生命周期里不准 - 设
{ popGesture: 'none' }禁用，设{ popGesture: 'close' }恢复 -
setStyle是异步操作，无回调，别依赖它“立即生效”——动画或弹窗逻辑要预留缓冲
关键点：不能只在弹窗 open() 时关，必须在 close() 回调里重新开，否则用户点左上角返回会失灵。
别碰 navigationStyle: "custom" 来禁侧滑
有人想“绕开配置”，直接设 navigationStyle: "custom"，以为能顺便禁掉侧滑。这是典型误用：
- 它会让所有平台（包括小程序）丢弃原生导航栏，导致小程序页面顶到状态栏下，必须手动适配安全区
- H5 下会失去浏览器原生前进/后退手势支持，
history.back()虽可用，但体验割裂 - 你得自己实现标题、返回按钮、右上角胶囊，成本远超需求
真正要的只是禁侧滑，不是重做整套导航。用错方案，后面全是兼容性债。
最容易被忽略的是平台边界：iOS 侧滑是 WKWebView 的 interactivePopGestureRecognizer，安卓是 WebView 的滑动手势，H5 根本没有这回事——三者机制完全不同，不存在“一套代码通吃”的解法。
