Android Toolbar菜单不显示选项问题排查求助

针对你遇到的Toolbar菜单仅显示空白图标、选项不展示的问题，结合你提供的代码和appcompat 1.5.1版本，给出以下排查和修复步骤：

1. 为菜单Item添加showAsAction属性 #

你的菜单XML未指定item的展示方式，appcompat Toolbar需要使用app命名空间的showAsAction来控制菜单显示行为。修改菜单代码如下：

<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android"
      xmlns:app="http://schemas.android.com/apk/res-auto">
    <!-- 放到溢出菜单 -->
    <item 
        android:title="@string/toolbar_menu_1"
        app:showAsAction="never"/>
    <!-- 有空间时显示图标+文字，无空间则放入溢出菜单 -->
    <item 
        android:title="@string/toolbar_menu_2"
        android:icon="@drawable/ic_comment"
        app:showAsAction="ifRoom|withText"/>
</menu>

showAsAction常用值说明：

• ifRoom：Toolbar有剩余空间时直接显示
• never：始终隐藏在溢出菜单中
• withText：同时展示图标和文字（空间充足时生效）

2. 检查Toolbar样式冲突 #

查看@style/ToolbarStyle是否存在影响菜单显示的设置：

• 文字颜色与Toolbar背景色一致，导致菜单标题不可见
• 自定义了溢出菜单图标但资源无效或透明
• 样式中的android:theme属性覆盖了默认菜单样式

建议先临时移除style="@style/ToolbarStyle"，用默认样式测试是否恢复正常，再逐步排查样式问题。

3. 代码中手动加载菜单（替代布局引用） #

如果布局中通过app:menu直接引用无效，可在Activity/Fragment中手动加载菜单：

Kotlin示例 #

val toolbar = findViewById<androidx.appcompat.widget.Toolbar>(R.id.toolbar)
setSupportActionBar(toolbar)
toolbar.inflateMenu(R.menu.menu_toolbar)
// 菜单点击监听
toolbar.setOnMenuItemClickListener { item ->
    when(item.itemId) {
        R.id.xxx -> {
            // 处理对应菜单逻辑
            true
        }
        else -> false
    }
}

Java示例 #

Toolbar toolbar = findViewById(R.id.toolbar);
setSupportActionBar(toolbar);
toolbar.inflateMenu(R.menu.menu_toolbar);
toolbar.setOnMenuItemClickListener(item -> {
    switch (item.getItemId()) {
        case R.id.xxx:
            // 处理对应菜单逻辑
            return true;
        default:
            return false;
    }
});

也可以通过重写onCreateOptionsMenu加载菜单（需先调用setSupportActionBar(toolbar)）：

override fun onCreateOptionsMenu(menu: Menu?): Boolean {
    menuInflater.inflate(R.menu.menu_toolbar, menu)
    return true
}

4. 验证资源有效性 #

• 确认@string/toolbar_menu_1、@string/toolbar_menu_2已在strings.xml中正确定义，无拼写错误
• 检查ic_comment图标资源是否存在，且图标颜色与Toolbar背景有足够对比度（避免因同色/透明导致看起来是空白）

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