onBackPress是App端唯一可靠返回键拦截入口，必须定义在页面级Vue实例中且return true才生效；混用plus.key.addEventListener或写错位置会导致失效。
onBackPress 是 App 端唯一可靠、可预测的返回键拦截入口，但必须写在页面级 Vue 实例中，且 return true 才生效；写错位置、漏 return、混用 plus.key.addEventListener 都会导致拦截失效或行为不一致。
onBackPress 必须定义在页面级，不能写在组件里
很多人把 onBackPress 放进自定义组件（比如 Header.vue）里，结果完全不触发。它只在 pages/xxx.vue 这类页面文件的 export default 对象中有效，和 data、methods 同级。
- ✅ 正确位置：
pages/detail/detail.vue的export default { onBackPress() { ... } } - ❌ 错误位置：
components/MyHeader.vue里定义onBackPress，不会被调用 - ⚠️ 注意：App.vue 中定义的
onBackPress不会拦截子页面返回，仅对 App.vue 自身生效（它不是“根监听器”）
return true 是硬性要求，否则默认行为立即执行
onBackPress 是同步函数，执行完就决定是否放行。不 return、return false、return undefined，等价于没拦截——页面瞬间退回上一页，你弹的 uni.showModal 还没出来，用户已经不在当前页了。
- ✅ 必须第一句就
return true，再异步处理逻辑（如弹窗、API 校验） - ❌ 写成
if (confirm) { uni.navigateBack(); return true; }—— 条件不满足时没 return，照样退页 - ⚠️ 常见陷阱：在
success回调里uni.navigateBack()，但忘了在res.cancel分支里什么也不做（这是对的），只要没意外 return 其他值就行
区分 from 来源，避免干扰 navigateBack 主动调用
onBackPress 的参数 options.from 只有两个值：'backbutton'（物理键或导航栏左上角按钮）和 'navigateBack'（JS 调用）。如果你只想干预用户按返回键，就得过滤掉后者，否则自己调用 uni.navigateBack() 也会触发这个钩子，可能造成死循环。
- ✅ 推荐写法：
if (options.from !== 'backbutton') return false;，让主动跳转走默认逻辑 - ❌ 不加判断直接
return true，会导致uni.navigateBack()后页面卡住不动 - ⚠️ 小程序平台下
from字段不可靠，但 App 端稳定可用，放心用
双击退出、后台驻留等全局逻辑不能只靠 onBackPress
首页双击退出、按一次提示“再按退出”、或者隐藏到后台而非退出——这类需求跨页面，不能依赖单页的 onBackPress。App 端必须用 plus.key.addEventListener('backbutton')，但它有严格前提：
- ✅ 必须包裹在
// #ifdef APP-PLUS中，否则 H5 / 小程序编译报错 - ✅ 必须等
document.addEventListener('plusready', ...)触发后才能注册，否则plus对象未就绪 - ❌ 不能在
onLaunch里直接写plus.key.addEventListener，此时plus还没初始化 - ⚠️ 注册后记得在合适时机
removeEventListener，否则多个页面重复注册会触发多次回调
最易忽略的一点：安卓 WebView 嵌套场景下，onBackPress 虽能捕获事件，但你要手动查 web-view 实例是否还能 canBack，否则直接 uni.navigateBack() 会退到空白页。这不是 bug，是混合渲染层的必然分工。
