onBackPress需按options.from区分处理：仅拦截'backbutton'（物理键/侧滑），放行'navigateBack'（JS调用）；双击退出逻辑应统一放在App.vue中管理。
onBackPress 是 App 端唯一能稳定捕获物理返回键的入口，但直接写 return true 会拦死所有返回行为——包括右上角返回按钮、uni.navigateBack() 调用，甚至导致页面栈卡死。必须按来源区分处理。
只拦截物理键，放过 JS 主动返回
关键不是“要不要弹窗”，而是“谁触发的”。onBackPress 的 options.from 字段决定是否该干预：
-
options.from === 'backbutton'：安卓物理键、iOS 侧滑（需"popGesture": "close"）、部分安卓导航栏返回按钮——这是你该弹确认的地方 -
options.from === 'navigateBack'：JS 调用uni.navigateBack()或路由跳转触发——不该拦截，否则用户点“返回”按钮没反应 - 不判断
from直接return true→ 所有返回失效，页面退不出去
双击退出逻辑必须放在 App.vue
业务页里的 onBackPress 只对当前页生效。首页双击退出、其他页弹确认，这种全局策略不能分散在各页面里：
- 在
App.vue的onLaunch或onShow中初始化一个时间戳变量（如this.lastBackTime = 0） -
onBackPress里检查：if (options.from === 'backbutton') { const now = Date.now(); if (now - this.lastBackTime - 别在多个页面重复绑定
plus.key.addEventListener('backbutton')，它和onBackPress冲突，且仅 App-PLUS 有效
H5 平台无法拦截，必须降级处理
onBackPress 在 H5 完全不触发——浏览器地址栏后退、手势、Alt+← 都绕过它。这不是 bug，是浏览器安全限制：
- 不要用
// #ifdef H5包裹onBackPress，它编译通过但运行无效 - 真要兼容 H5，得靠
history.back()，但它不走 uni-app 页面栈；刷新后getCurrentPages()为空，uni.navigateBack()静默失败 - 简单方案：H5 下不弹确认，直接
history.back()；复杂场景需结合beforeunload（仅限表单未提交等有限场景）
常见错误：导航栏样式没设对，onBackPress 压根不触发
默认导航栏（"navigationStyle": "default"）下，左上角返回按钮是原生渲染的，onBackPress 不会回调——这是平台级限制，不是代码问题：
- 必须在
pages.json对应页面配置"navigationStyle": "custom" - iOS 侧滑返回要生效，还得加
"popGesture": "close" - Android 物理键不受此影响，但用户习惯点左上角，不设 custom 就等于没监听到主要操作入口
真正难的不是写弹窗，而是让「物理键」和「导航栏按钮」都进入同一处理路径，同时不破坏 JS 跳转逻辑。很多人卡在 options.from 判断漏掉或写反，结果要么拦不住，要么拦过头。
