uni-app中无法修改Tabbar图标，需先区分原生与自定义：原生Tabbar（pages.json配置）仅支持静态本地图标，不支持运行时动态更换；若需动态换图、红点等交互，必须使用自定义Tabbar。
uni-app 里改不了 Tabbar 图标？先确认你用的是原生还是自定义
uni-app 的底部 Tabbar 分两种：一种是 pages.json 里配置的原生 Tabbar（由小程序/APP 原生渲染），另一种是自己用 view + image 拼的自定义 Tabbar。只有前者支持“原生图标替换”，但限制极多——比如 iOS 下图标必须是纯黑或纯白，Android 要求尺寸严格，且**不支持运行时动态换图**。
常见错误现象：tabBar.selectedIconPath 改了路径却没变化，或者图标变灰、拉伸、不显示。原因基本是路径不对、格式不符，或误以为能用 JS 动态赋值。
- 路径必须是本地静态资源，不能是网络地址或变量拼接（如
"static/tabs/home-active.png"✅，"/static/tabs/" + activeTab + ".png"❌） - 图标尺寸建议统一为 81×81px（iOS 推荐），Android 建议 96×96px；实际显示会缩放，但比例失真就糊
- 微信小程序要求 icon 是 PNG，不支持 SVG；App 端（iOS）要求图标为纯 alpha 通道（即透明底+黑白图），否则选中态变灰
pages.json 配置 Tabbar 图标的关键参数和陷阱
pages.json 中的 tabBar 节点控制原生 Tabbar，但图标字段名容易混淆：iconPath 是未选中态，selectedIconPath 是选中态，二者必须同时存在且路径有效，否则默认回退到文字。
性能影响很小，但兼容性差：H5 端完全不生效（H5 默认无原生 Tabbar），App 端在 iOS 上对 selectedIconPath 的颜色识别极其敏感——哪怕图片带一点点灰色，选中后就发灰甚至不可见。
- 路径写法必须以
static/开头，不能用@/别名或相对路径（如./static/…） - 图标文件要放在
static目录下，不能放在components或assets - 微信小程序要求两个图标尺寸一致；App 端 Android 对尺寸容忍度稍高，但 iOS 必须严格匹配文档建议值
- 改完记得删掉
unpackage目录再重新运行，否则旧缓存图标可能残留
想真正“动态”换图标？只能放弃原生 Tabbar，手写一个
如果你的需求是点击切换、登录后变图标、红点数量驱动图标变化——原生 Tabbar 从底层就不支持。必须用自定义 Tabbar：用 tabBar 关闭原生，然后在每个页面底部放一个 view，用 v-for 渲染 tab 项，图标用 image 绑定 :src，通过 current 变量控制激活态。
这样做的代价是：失去原生导航能力（比如微信小程序的“首页”快捷入口）、需要手动处理页面跳转和生命周期（uni.switchTab 仍可用，但路由状态得自己维护）、H5 端需额外适配 fixed 定位层级问题。
- 关键代码片段：
<view class="custom-tabbar"> <view v-for="(item, index) in tabList" :key="index" @click="switchTab(index)"> <image :src="current === index ? item.activeIcon : item.icon"></image> </view> </view> - 图标路径可为变量，支持条件判断、计算属性、甚至接口返回的 URL（但注意跨域和缓存）
- 红点、角标、徽标数等 UI 变化，全由 Vue 数据驱动，无平台限制
uni-app 的 setTabBarItem 为什么几乎没用
这个 API 名字听起来很诱人，但实际只在微信小程序基础库 2.25.0+ 以上版本支持，且仅限修改文字、颜色、角标（text / textColor / backgroundColor / badgeText），不能改图标路径。调用 uni.setTabBarItem 并传入 iconPath 字段，会被直接忽略。
错误现象：控制台无报错，但图标纹丝不动；或在 H5/App 端直接报 not function 错误。
- 该 API 不是跨端方案，仅微信小程序部分支持，其他平台（包括支付宝、抖音、App）均未实现
- 即便在微信小程序中，也仅支持修改已配置在
pages.json中的 tab 项，不能新增或删减 - 别被文档里“支持 iconPath”误导——那是历史遗留描述错误，实测无效
真正复杂的点不在怎么写，而在判断清楚：你要的“动态”到底是视觉反馈（比如点击闪一下），还是状态驱动（比如消息数 > 0 才显示小红点），又或是权限驱动（比如管理员才显示“设置”tab）。这些都绕不开自定义 Tabbar，而自定义意味着你要接管跳转、高亮、动画、焦点管理——不是加几行代码就能搞定的事。
