应优先在pages.json中配置"app-plus": {"tabBar": {"visible": false}}，APP端生效；微信小程序/H5需在onReady中调用uni.hideTabBar({animation: false})；showTabBar须在每个tabbar页onShow中显式调用；自定义tabBar仍需hideTabBar；非tabbar页调用会报错，应改用v-if控制自定义组件显隐。
uni.hideTabBar() 调用时机不对，页面一加载就闪一下
常见现象是：页面刚打开时 tabBar 先显示半秒，再消失。这是因为 uni.hideTabBar() 在 onLoad 或 onShow 中调用太晚——原生 tabBar 已经渲染完成，只能“后置隐藏”，造成视觉闪烁。
真正有效的做法是：在页面配置中提前声明隐藏意图，再补 API 强制兜底：
- 在
pages.json对应页面的style下加"app-plus": {"tabBar": {"visible": false}}（仅 APP 端生效） - 微信小程序/H5 端不支持该配置，必须靠 JS 控制，但要改用
onReady而非onLoad：此时视图树已挂载、原生 tabBar 尚未完全就绪，隐藏更及时 - 加上
animation: false参数避免过渡动画干扰：uni.hideTabBar({ animation: false })
uni.showTabBar() 失效，返回后 tabBar 不见了
典型场景：从 tabbar 页面 A 跳转到非 tabbar 页面 B（如登录页），B 隐藏 tabBar；B 登录成功后 uni.switchTab 回 A，结果 A 的 tabBar 没出来。
根本原因是：uni-app 的 uni.showTabBar() 只对当前活跃页面生效，而 switchTab 切换时，目标页面 A 的 onShow 生命周期会触发，但你没在那里重新调用 showTabBar。
正确写法是在每个需要显示 tabBar 的页面的 onShow 中显式恢复：
export default {
onShow() {
uni.showTabBar({ animation: false })
}
}
注意：onShow 比 onLoad 更可靠——页面可能被缓存，onLoad 不一定每次触发。
自定义 tabBar 时，uni.hideTabBar() 还要不要调用
要，而且必须调用。
即使你在 pages.json 中设置了 "tabBar": {"custom": true}，原生 tabBar 仍会在部分平台（尤其是 iOS App 和某些安卓厂商机）上短暂闪现。不调用 uni.hideTabBar()，用户可能看到“原生 tabBar → 消失 → 自定义 tabBar 上来”的两段式切换。
实操建议：
- 在
app.vue的onLaunch和onShow中都执行一次uni.hideTabBar({ animation: false })，确保全局压制 - 自定义 tabBar 组件内部，不要依赖
uni.getTabBar()—— 开启custom: true后，这个 API 返回undefined - 状态同步靠
uni.onTabItemTap监听，别用getCurrentPages()推断当前 tab，容易错位
H5 和小程序里 hideTabBar 报错“not TabBar page”
错误信息：setTabBarItem:fail not TabBar page 或 hideTabBar:fail not TabBar page，本质是平台限制：H5 和微信小程序要求这些 API 只能在 tabBar 配置列表里的页面中调用。
也就是说，如果你在非 tabbar 页面（比如 pages/login/index，没出现在 tabBar.list 里）调用 uni.hideTabBar()，就会失败。
解决路径只有两条：
- 把该页面加进
tabBar.list（哪怕设visible: false），让它成为“合法 tabBar 页面” - 改用条件渲染：在根组件（如
App.vue）用v-if控制自定义 tabBar 组件的显示，通过全局状态（如uni.$tabBarVisible）控制显隐，绕过原生 API 限制
后者更可控，但要注意：H5 端无法监听路由变化自动更新状态，需配合 uni.addInterceptor 或 onPageScroll 手动同步。
最易被忽略的一点：APP 端的 tabBar.visible: false 配置只在首次加载页面时有效，热重载或页面复用后可能失效，所以 onShow + hideTabBar 是唯一稳态方案。
