本文详解如何通过 java 代码在运行时动态更新 bottomnavigationview 中指定菜单项的图标（如未读通知红点图标），并推荐使用 material 3 官方支持的 badge 机制替代手动换图，兼顾规范性与可维护性。

本文详解如何通过 java 代码在运行时动态更新 bottomnavigationview 中指定菜单项的图标（如未读通知红点图标），并推荐使用 material 3 官方支持的 badge 机制替代手动换图，兼顾规范性与可维护性。

在 Android 开发中，BottomNavigationView 是实现底部导航栏的标准组件。当需要根据业务状态（例如存在未读通知）动态改变某一项的视觉表现时，常见需求是高亮或替换图标。虽然可通过 setIcon() 手动切换图标资源，但 Material Design 3 更推荐使用 Badge（徽章） 进行未读提示——它语义清晰、适配深色模式、支持动画且无需额外图标资源。

✅ 推荐方案：使用 Badge（Material 3+）

自 Material Components 1.8.0 起，BottomNavigationView 原生支持 Badge API。只需调用 getOrCreateBadge() 即可为指定菜单项添加/更新徽章：

BottomNavigationView bottomNav = findViewById(R.id.bottomNavigationView);

// 假设 notification 菜单项的 ID 为 R.id.menu_notification
BadgeDrawable badge = bottomNav.getOrCreateBadge(R.id.menu_notification);
badge.setVisible(true);     // 显示徽章
badge.setNumber(3);         // 可选：显示数字（如“3”条未读）
badge.setBackgroundColor(ContextCompat.getColor(this, R.color.red_500));
badge.setTextColor(ContextCompat.getColor(this, R.color.white));

? 注意：R.id.menu_notification 必须与 @menu/bottom_nav.xml 中对应 的 android:id 一致。若仅需红点（无数字），调用 badge.setNumber(0) 并保持 setVisible(true) 即可渲染纯色圆点。

⚠️ 备用方案：手动更换图标（兼容旧版或特殊场景）

若因兼容性或设计需求必须更换图标（如使用带红点的静态 drawable），可通过 Menu API 操作：

Menu menu = bottomNav.getMenu();
MenuItem notificationItem = menu.findItem(R.id.menu_notification);
notificationItem.setIcon(R.drawable.ic_notification_red); // 替换为自定义图标

⚠️ 重要限制与注意事项：

• setIcon() 会完全替换原始图标，丢失 app:itemIconTint 的颜色控制；
• 图标尺寸需严格匹配（建议使用 vector drawable 并统一设置 android:width/height）；
• 若启用 app:labelVisibilityMode="labeled"，图标更换后文字颜色不受影响，但需确保新图标与文字的可读性对比度达标；
• 不推荐在 onCreate() 中直接调用 setIcon() —— 应确保 BottomNavigationView 已完成菜单 inflate（通常在 setOnItemSelectedListener 设置后操作更稳妥）。

✅ 最佳实践总结

场景	推荐方式	优势
未读消息提示（含数字/红点）	getOrCreateBadge()	符合 Material 规范、自动适配、支持动画、无需额外资源
自定义图标样式（如品牌化图标）	MenuItem.setIcon()	灵活可控，适合非标准提示
需要动态切换多状态图标（如已读/未读/错误）	结合 setIcon() 与状态管理	适用于复杂 UI 状态机

最后提醒：无论采用哪种方式，请始终在主线程操作 UI，并在 Activity/Fragment 生命周期安全时调用（例如避免在 onDestroy() 后更新 Badge）。对于通知状态，建议将 Badge 更新逻辑封装进统一的通知管理器，便于后续扩展（如清除徽章、联动 Push 服务等）。