uni-app iOS侧滑返回拦截失败是因为系统级手势不触发onBackPress，需在pages.json中配置"popGesture":"close"关闭原生侧滑，再手动实现touch事件监听与动画退回。
uni-app 侧滑返回为什么拦截不了？
因为 onBackPress 默认不处理手势返回，iOS 真机侧滑是系统级导航行为，uni-app 的 JS 层根本收不到事件——除非你主动关闭原生侧滑，把控制权交还给 WebView。
- 真机调试时，
onBackPress只响应物理返回键或uni.navigateBack()调用，对 iOS 侧滑完全无感 - H5 和微信小程序里没这问题，但 App 平台（尤其是 iOS）必须走原生层干预
- uni-app 3.0+ 提供了
enablePullDownRefresh类似的底层开关，但侧滑返回的开关叫popGesture，藏在pages.json里
pages.json 中怎么关掉原生侧滑？
不是写 JS，是改配置。每个页面单独控制，全局配置只影响新页面，已打开的页面不会动态生效。
- 在
pages.json对应页面的style节点下加："popGesture": "none" - 如果想保留部分页面可侧滑（比如首页不能退，详情页可以），就只在详情页配置
"popGesture": "close"（注意：uni-app 文档写的是"none"，实测"close"才生效，"none"反而可能被忽略） - 安卓平台设成
"none"后，物理返回键也不触发onBackPress，得手动监听plus.key.addEventListener('backbutton')
{
"path": "pages/detail/detail",
"style": {
"popGesture": "close"
}
}
拦截后怎么手动实现侧滑手势？
关掉原生侧滑只是第一步，真正要“自定义手势”，得自己接 touchstart/touchmove/touchend，但 WebView 的 touch 事件有延迟、不准、易误触——尤其在 iOS 上。
- 别直接在
<view>上绑@touchstart，优先用uni.createSelectorQuery()拿到根容器再监听，避免被滚动区域截断 - 判断侧滑方向不能只看
clientX差值，要结合touches[0].target是否在左边缘 40px 内，否则一滑列表就退了 - 手势过程中禁止页面滚动：给根容器加
touch-action: pan-y（CSS），否则 iOS 会抢走横向事件 - 动画退回建议用
transform: translateX()+transition，别用left或margin，重排代价高
为什么 onBackPress 里调 uni.navigateBack 不起作用？
因为 onBackPress 触发时，页面还没开始退场，此时调 uni.navigateBack() 会和原生退场逻辑冲突，结果就是卡住或闪退。
- 正确做法是在
onBackPress返回true，表示“我拦住了”，然后自己控制退场动画 + 定时器后调uni.navigateBack({delta: 1}) - 千万别在
onBackPress里直接 return false，uni-app 会当成“不处理”，继续走原生逻辑 - 安卓上如果用了
plus.key监听返回键，记得在页面onUnload里removeEventListener，否则内存泄漏
popGesture 配置改完必须重新编译安装，热更新不生效。 
