uni.navigateTo 是保留当前页、支持返回的压栈式跳转,适用于列表→详情等需回退场景;页面栈上限10层,超限静默失败;参数仅通过URL query传递,onLoad接收,onShow才触发返回逻辑。

uni.navigateTo 是最常用也最需谨慎使用的跳转方式,但“怎么跳”不能只看一个 API——选错方式会导致页面栈爆炸、返回逻辑错乱、参数拿不到、甚至白屏。
什么时候必须用 uni.navigateTo?
仅当明确需要「保留当前页 + 支持返回」时才用它。比如列表页点进详情页、表单页跳确认页、多步流程中任意一步需回退修改。
- 它会把目标页压入页面栈,原页面实例保留在内存中(定时器、音频、滚动位置都还在)
- 小程序端栈深上限为 10 层,
uni.navigateTo每调一次 +1,超限后静默失败,控制台可能只报navigateTo:fail page limit exceeded: 10 -
onLoad只能拿到 URL query 参数,extraData必须在onShow里通过getCurrentPages()才能读到 - 别在
onLoad里写刷新逻辑——返回时它根本不触发,得挪到onShow
uni.redirectTo 替换当前页的典型误用场景
很多人用 uni.navigateTo 跳登录成功页或支付结果页,结果用户狂按返回键回到空表单甚至重复提交。这类“一次性终点页”,必须用 uni.redirectTo。
- 它会销毁当前页,栈深度不变,适合登录跳首页、提交跳完成页、中间跳板页(如权限校验页)
- 不能跳 tabBar 页面,如果目标页在
pages.json的tabBar里,会直接报错 - 传参方式和
navigateTo一致,但目标页onLoad仍只能收 URL query
uni.reLaunch 和 uni.switchTab 的关键区别
两者都会清栈,但清法不同,混用就丢状态。
-
uni.reLaunch是“全盘重开”:关闭所有页面,只留目标页。退出登录、切换账号、强制回到首页必须用它 -
uni.switchTab是“切 Tab 专用”:只关非 tabBar 页,保留 tabBar 页,并跳转到指定 tab。它不支持传参,且目标页生命周期走的是onShow而非onLoad - 想跳 tabBar 页面却用了
reLaunch或redirectTo,页面能打开但 tab 底部高亮错位,这是常见 UI 异常
返回时怎么触发刷新或判断来源?
onShow 是唯一可靠入口,不是 onLoad,也不是 onUnload。
- 所有返回行为(物理键、左上角、
uni.navigateBack)、切前台、从后台恢复,都会触发onShow - 要区分“首次进入”和“从某页返回”,得手动查栈:
const prevPage = getCurrentPages()[getCurrentPages().length - 2],再比对prevPage.route - 跨页通信别用全局事件总线,
eventChannel更安全——但必须在目标页onLoad里绑定,onShow里绑就失效 - URL 传参含中文或对象时,务必
encodeURIComponent(JSON.stringify(obj)),接收端反向解包,否则 H5 端大概率乱码或截断
页面栈不是黑盒,是可查、可判、可控的状态链。真正难的不是写对一行 uni.navigateTo,而是每次跳转前问自己一句:这个页面,用户还需要回来吗?


















