uni.setTabBarBadge在App端无反应是因为仅支持原生tabBar且需页面已挂载，text必须为字符串，Android桌面角标受厂商限制，跨页面状态不同步需手动同步。
uni.setTabBarBadge 在 App 端为什么没反应？
直接调用 uni.setTabBarBadge 却看不到角标，不是代码写错了，而是它只管「原生 tabBar」——仅在 App（iOS/Android）和微信小程序生效，H5 完全不支持，支付宝、百度等小程序也大概率无效。更关键的是：它只作用于当前已渲染的 tabBar，如果页面还没加载完 tabBar（比如刚启动或路由跳转中），调用就白费。
- 必须确保页面已挂载且 tabBar 已初始化，推荐在
onShow或onReady后加setTimeout延迟 100–300ms 再执行 -
text参数必须是字符串，'0'会显示“0”，0（数字）则静默失败，不报错也不显示 - Android 真机上，即使 API 调用成功，桌面图标角标仍可能不出现——那是厂商级限制，和这个 API 无关
App 桌面图标红点 ≠ tabBar 红点，别混用
uni.showTabBarRedDot 和 uni.setTabBarBadge 控制的是底部导航栏项右上角的小红点或数字，属于 uni-app 原生渲染层；而手机桌面图标右上角的角标（俗称“桌面红点”），是操作系统级功能，uni-app 默认完全不处理，必须对接各厂商 SDK。
- 华为需集成 HMS Core 的
NotificationBadge，并申请android.permission.NOTIFICATION_BADGE - 小米依赖 MIUI 的「桌面角标」开关，且必须通过系统通知（
PushMessage）触发，单独调 API 无效 - OPPO/VIVO/荣耀大多只响应通知数量变化，你得发一条不可见通知，再调
setNotificationNumber - 所有厂商都要求用户手动开启「桌面图标角标」权限，代码无法绕过
跨页面红点状态不同步？因为 tabBar 状态不共享
你在消息页调了 uni.setTabBarBadge({ index: 2, text: '3' })，切到首页就没了——这不是 bug，是 uni-app 的设计事实：tabBar 角标状态不会自动跨页面保持。每个页面生命周期独立，除非你主动同步。
- 全局状态建议用
uni.$emit/uni.$on或 pinia/vuex 统一管理未读数，所有页面onShow时重新计算并设置 - 避免在子组件或异步回调里直接调用角标 API，容易因页面未激活导致失效
- 清除逻辑要成对：有
uni.setTabBarBadge就该配uni.removeTabBarBadge，别只靠text: '0'试图“清空”
真机调试前必须确认的三件事
很多“红点不显示”问题，其实卡在最基础的环节上，而不是 API 本身。
- 确认目标平台是 App（非 H5 或其他小程序），且已启用原生 tabBar（
"tabBar"配置存在于pages.json） - Android 测试机是否已打开「桌面图标角标」权限（路径通常为：设置 → 应用管理 → [你的App] → 通知管理 → 桌面角标）
- iOS 真机需检查是否开启了通知权限（
UNAuthorizationStatus.authorized），否则角标 API 调用会被系统静默丢弃
桌面角标这事，本质是「三方协议+用户授权+系统版本」三重门，uni-app 只开了第一道门，后面两道得你自己一一手动敲开。
