正确调用 uni.hideTabBar 应在 app.vue 的 onLaunch 和 onShow 中立即执行并加 fail 回调;自定义 tabbar 需设 pages.json 中 "custom": true;页面跳转必须用 switchTab 而非 navigateTo。

uni.hideTabBar 调用时机不对,闪屏照旧
很多人在 onShow 里调用 uni.hideTabBar(),结果首次切换仍闪一下。这是因为页面已开始渲染、原生 tabbar 还没来得及隐藏,webview 底层先画了一帧白底+原生栏,再切掉——用户就看到了“Duang”那一闪。
正确做法是:在 app.vue 的 onLaunch 和 onShow 中**立即**调用,且加 fail 回调兜底:
onLaunch() {
uni.hideTabBar({ fail: () => setTimeout(() => uni.hideTabBar(), 50) })
},
onShow() {
// 避免从后台切回时原生栏意外弹出
uni.hideTabBar({ fail: () => uni.showTabBar({}) }) // 反向保底
}
关键点:fail 不是可选,而是必填——部分安卓小程序在冷启动时 hide 失败率超 30%,不处理就会暴露原生栏。
自定义 tabbar 组件用了 v-if,一换页就重渲染
把 tabbar 写在每个页面里,又用 v-if="currentTab === 0" 控制子页面显示,等于每次切换都销毁重建整个 DOM 树。组件实例没了,图标加载、状态重置、CSS 重排全来一遍,低端机上延迟明显。
换成 v-show 是最低成本修复:
-
v-show只切display: none,DOM 保留在内存,无重建开销 - 配合
keep-alive(需在 pages.json 中开启"enablePullDownRefresh": false等兼容配置)能进一步保留页面状态 - 务必给 tabbar 容器加
position: fixed; bottom: 0; z-index: 999;,避免v-show切换时触发父容器重排
page.json 配置漏了 custom: true,原生和自定义同时抢位
如果只在代码里 hide,但 pages.json 的 tabBar 没设 "custom": true,uni-app 会默认启用原生 tabbar 渲染逻辑。此时你 hide 的只是“显示”,底层仍在做 tabbar 生命周期管理,导致样式计算冲突、高度抖动、甚至 iOS 上出现 1px 白边。
必须显式声明:
"tabBar": {
"custom": true,
"color": "#666",
"selectedColor": "#007AFF",
"backgroundColor": "#ffffff",
"list": [
{ "pagePath": "pages/index/index", "text": "首页" },
{ "pagePath": "pages/user/user", "text": "我的" }
]
}
注意:"custom": true 后,uni.hideTabBar() 才真正生效;否则它只是个无效操作,日志里都看不到报错。
切换页面用 navigateTo 而不是 switchTab,tabbar 状态锁不住
用 uni.navigateTo({ url: '/pages/user/user' }) 跳转,哪怕目标页在 tabBar list 里,uni-app 也会把它当普通页面推入栈——tabbar 组件无法感知路由变化,currentTab 状态滞留在旧值,视觉上就是“点了没反应”或“点了闪一下才高亮”。
所有 tabBar 页面间跳转,必须用:
-
uni.switchTab({ url: '/pages/user/user' })—— 强制走 tabBar 路由,触发原生切换流程 - 搭配全局状态(如 Pinia store 或
globalData)同步currentTab,避免多个页面实例状态不一致 - 在自定义 tabbar 组件的
onLoad里读取当前路由,而非仅依赖点击事件更新
最易忽略的是:tabBar 页面之间禁止用 redirectTo 或 reLaunch,它们会清空栈,导致返回逻辑断裂,间接引发二次闪屏。











