uni.switchTab是唯一能跳转到tabBar页面的可靠方式，因其专为tabBar设计，要求目标页必须在pages.json的tabBar.list中声明，且不支持URL传参，需用onShow刷新、setStorageSync或事件总线中转参数。
直接用 uni.switchtab，别用 uni.navigateto 或 uni.redirectto —— 后两者对 tabbar 页面无效，会静默失败。
为什么 uni.switchTab 是唯一可靠方式
TabBar 页面在 uni-app 中属于“特殊路由”，平台（微信小程序、App、H5）强制要求通过专用 API 跳转。调用 uni.switchTab 时：
- 目标页面必须在
pages.json的tabBar.list中声明，否则报错page is not found - 页面若已加载，
onLoad不触发，只触发onShow—— 刷新逻辑得放在这里 - 路径必须是绝对路径（如
/pages/home/index），不能带参数查询字符串 - 不支持传参，需改用
uni.setStorageSync或事件总线中转
pages.json 中的 tabBar 配置不能少
即使你后续打算自定义 TabBar 组件，也必须先在 pages.json 中完整配置 tabBar.list，否则 uni.switchTab 无法识别目标页：
{
"tabBar": {
"color": "#7A7E83",
"selectedColor": "#007AFF",
"backgroundColor": "#ffffff",
"list": [
{
"pagePath": "pages/home/index",
"text": "首页",
"iconPath": "static/tabbar/home.png",
"selectedIconPath": "static/tabbar/home-active.png"
},
{
"pagePath": "pages/user/profile",
"text": "我的",
"iconPath": "static/tabbar/user.png",
"selectedIconPath": "static/tabbar/user-active.png"
}
]
}
}
注意：pagePath 必须与 pages 节点中注册的路径完全一致；图标路径仅支持本地静态资源，不支持网络地址或 base64。
点击 Tab 时如何同步更新当前页和高亮状态
如果你用的是原生 TabBar，高亮由平台自动处理，无需手动控制；但如果你隐藏了原生 TabBar、改用自定义组件（比如带滑块动画的 tab），则必须手动同步：
- 点击 tab 项后，先调用
uni.switchTab({ url: '/pages/xxx' }) - 在目标页面的
onShow中，通过getCurrentPages()或全局状态判断是否为当前激活页 - 自定义组件内用
ref+nextTick测量 DOM 宽度/位置来更新滑块left和width，否则首次渲染时尺寸为 0 - 避免在
onLoad中计算滑块位置 —— 此时 DOM 可能未挂载完成
自定义 TabBar 时容易忽略的兼容性点
自定义方案灵活，但几个坑几乎人人踩过：
-
custom: true后，原生 TabBar 彻底消失，但switchTab仍依赖pages.json中的list配置 —— 少配一项，跳转就失败 - 安卓真机上，
position: fixed的自定义 TabBar 在软键盘弹起时可能被顶起，需监听keyboardHeight动态调整bottom - 微信小程序中，自定义 TabBar 组件必须放在
components/下，且需在pages.json的tabBar.custom后显式引用，不能只靠v-if控制显示 - 切换 tab 后，如果页面内容没刷新，大概率是因为把数据请求写在了
onLoad而不是onShow
最常被漏掉的，是忘记在 pages.json 中为所有角色（如管理员、访客）都预设好全部 Tab 页面路径 —— 动态切换身份时，缺一个路径，switchTab 就直接报错退出。
