uni-app小程序端动态TabBar不能靠pages.json修改，因微信原生不支持运行时修改tabBar结构，pages.json为编译期配置；须启用custom-tab-bar并严格配对配置、路径及跳转逻辑。
uni-app小程序端动态TabBar为什么不能靠pages.json改？
因为微信小程序原生不支持运行时修改 tabBar 结构，pages.json 是编译期配置，打包后固化。哪怕你用 uni.setTabBarItem 或 uni.setTabBarStyle，也只能改图标颜色、文字、选中态样式——增删 tab 项、换顺序、根据登录态切换菜单，统统无效。真机上会静默失败，开发者工具可能报 setTabBarItem is not a function。
必须启用 custom-tab-bar 并手动控制跳转逻辑
微信小程序基础库 ≥2.1.0 支持自定义 tabBar，uni-app 封装了对应能力，但不是“写个组件就行”，得严格配对：
-
pages.json中必须设"tabBar": { "custom": true }，且list数组不能空（哪怕只填占位路径），否则部分低版本客户端 fallback 到原生 tabBar 导致错乱 - 组件路径必须是
components/custom-tab-bar/index.vue（大小写敏感），且每个使用该 tabBar 的页面的json文件里要显式声明"usingComponents": { "custom-tab-bar": "/components/custom-tab-bar/index.vue" } - 切换页必须调用
uni.switchTab({ url: '/pages/xxx' })，不能只改 UI 状态；否则页面没跳、高亮错位、路由栈混乱 - 组件内用
uni.getTabBar()获取实例仅在真机/真机调试下有效，模拟器返回undefined，别依赖它做初始化判断
登录态或角色变化后 tabList 不更新？
常见问题是：登录成功后，tabList 数据变了，但视图没重绘。这是因为 uni-app 的自定义 tabBar 组件不会自动响应外部状态变更：
- 不要把
tabList存在组件data里静态初始化，而应通过props接收（如isLogin、role），再用computed动态生成列表 - 登录成功后，别只改 store 或 data，要显式触发
this.$forceUpdate()或重置tabList引用（如this.tabList = [...newList]） - 权限类菜单还容易漏掉：所有 tab 对应的页面路径必须提前在
pages.json的pages数组里完整声明，否则uni.switchTab报page is not found
iOS 安全区和小程序残留高度怎么处理？
自定义 tabBar 最容易被忽略的兼容细节就在这两处：
- iOS 设备需加
padding-bottom: env(safe-area-inset-bottom)，否则 tab 被刘海遮住；建议用uni.getSystemInfoSync().platform === 'ios'做条件判断，别硬写 CSS - 即使设了
"custom": true，某些微信/支付宝基础库版本仍会在页面底部留出约 50px 原生 tabBar 高度，造成内容被顶高或空白；解决方式是在对应页面的<style>里加padding-bottom: 0 !important; margin-bottom: 0 !important; - 图标资源必须用本地绝对路径（如
/static/icon/home.png），网络地址在小程序端不生效；iconPath和selectedIconPath大小不能超 40kb
真正麻烦的不是写组件，而是状态同步、跨端适配、生命周期钩子时机——比如 H5 刷新后 getCurrentPages() 不准，得在 onShow 里重新推断当前页路径；比如小程序从后台切回，tab 高亮丢失，得监听 onResume 补同步。这些点不踩一遍，很难调稳。
