BottomNavigationView选中时图标颜色不切换问题求助

这种情况我碰到过好多次，大概率是选中状态的同步配置没做好或者颜色选择器没正确设置，咱们一步步排查：

1. 先检查颜色选择器的配置 #

BottomNavigationView的选中/未选中颜色需要用颜色选择器（Color Selector）来定义，默认情况下如果没配置，很容易出现选中状态不更新的问题：

• 在res/color目录下创建一个bottom_nav_color_selector.xml文件（名字自定义即可）：

<?xml version="1.0" encoding="utf-8"?>
<selector xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 选中状态的颜色 -->
    <item android:color="@color/your_selected_color" android:state_checked="true"/>
    <!-- 未选中状态的颜色 -->
    <item android:color="@color/your_unselected_color" android:state_checked="false"/>
</selector>

• 然后在activity_main.xml的BottomNavigationView标签里绑定这个选择器：

<com.google.android.material.bottomnavigation.BottomNavigationView
    android:id="@+id/bottom_nav"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    app:menu="@menu/bottom_nav_menu"
    <!-- 绑定图标颜色选择器 -->
    app:itemIconTint="@color/bottom_nav_color_selector"
    <!-- 文字颜色也可以一起绑定，保持视觉统一 -->
    app:itemTextColor="@color/bottom_nav_color_selector"/>

2. 确认Menu Item的ID与Fragment切换逻辑同步 #

如果是手动管理Fragment切换（没用Navigation Component），一定要在切换Fragment的同时，同步标记BottomNavigationView的选中状态：

比如在MainActivity的点击监听里：

bottom_nav.setOnItemSelectedListener { item ->
    when(item.itemId) {
        R.id.nav_home -> {
            // 切换到HomeFragment
            supportFragmentManager.beginTransaction()
                .replace(R.id.fragment_container, HomeFragment())
                .commit()
            // 关键：标记当前item为选中状态
            item.isChecked = true
            true
        }
        R.id.nav_dashboard -> {
            supportFragmentManager.beginTransaction()
                .replace(R.id.fragment_container, DashboardFragment())
                .commit()
            item.isChecked = true
            true
        }
        // 其他item同理处理
        else -> false
    }
}

如果用了Navigation Component，要确保BottomNavigationView和NavController正确绑定，不要手动处理切换逻辑：

val navController = findNavController(R.id.nav_host_fragment)
bottom_nav.setupWithNavController(navController)

这种情况下，menu里的item ID必须和navigation graph里的destination ID完全一致，否则选中状态会出现混乱。

3. 排查是否有样式覆盖问题 #

如果你的BottomNavigationView用了自定义样式，检查样式里是否直接设置了固定颜色，导致选择器失效：

<style name="BottomNavStyle" parent="Widget.MaterialComponents.BottomNavigationView">
    <!-- 错误示例：直接设置固定颜色会覆盖选择器 -->
    <!-- <item name="itemIconTint">@color/black</item> -->
    <!-- 正确做法：引用颜色选择器 -->
    <item name="itemIconTint">@color/bottom_nav_color_selector</item>
</style>

4. 检查默认选中项的设置 #

如果一开始默认选中的是第一个item，确保不要在多个地方重复调用setSelectedItemId()，避免状态冲突导致选中状态异常。

按照这几步排查下来，基本就能解决选中状态图标颜色不更新的问题了～

内容的提问来源于stack exchange，提问作者Jeavie