Android中Activity的ActionBar菜单不显示问题求助

我使用Java和Android Studio开发，给Activity的ActionBar添加了一个简单菜单，但菜单始终不可见，相关代码如下：

代码实现 #

@Override
public boolean onCreateOptionsMenu(Menu menu) {
    MenuInflater inflater = getMenuInflater();
    inflater.inflate(R.menu.add,menu);
    return super.onCreateOptionsMenu(menu);
}

清单文件（Manifest） #

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools">

    <application
        android:allowBackup="true"
        android:dataExtractionRules="@xml/data_extraction_rules"
        android:fullBackupContent="@xml/backup_rules"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/Theme.MyNote"
        tools:targetApi="31">
        <activity
            android:name=".MainActivity"
            android:exported="true">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

菜单XML文件（menu.xml） #

<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:android="http://schemas.android.com/apk/res/android">
    <item
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:enabled="false"
        android:icon="@drawable/baseline_add_"
        android:title="@string/add"
        app:showAsAction="always" />
</menu>

问题原因及解决方案 #

1. 菜单文件引用不匹配 #

代码中调用inflater.inflate(R.menu.add, menu);，但你提供的菜单XML文件名为menu.xml，系统会找不到对应的菜单资源。

• 解决方案：如果菜单文件确实是menu.xml，将代码修改为：

  inflater.inflate(R.menu.menu, menu);
  

  如果菜单文件名是add.xml，请确保res/menu目录下存在该文件。

2. 菜单Item被禁用 #

菜单Item设置了android:enabled="false"，这会让菜单处于不可用状态，部分主题下可能直接隐藏或显示为灰色难以分辨。

• 解决方案：移除android:enabled="false"属性（默认启用），或者将其改为true：

  android:enabled="true"
  

3. 图标资源无效 #

android:icon="@drawable/baseline_add_"的资源名称不完整，通常Material图标命名格式为baseline_add_24.xml，资源不存在会导致图标无法显示，甚至影响整个菜单的渲染。

• 解决方案：检查res/drawable目录下是否存在正确的图标资源，修正资源引用路径。

4. 主题未包含ActionBar #

清单文件中应用的主题是Theme.MyNote，如果该主题继承自NoActionBar系列（比如Theme.MaterialComponents.DayNight.NoActionBar），Activity将没有ActionBar，自然无法显示菜单。

• 解决方案：修改主题为带ActionBar的版本，比如在res/values/styles.xml中：

  <style name="Theme.MyNote" parent="Theme.MaterialComponents.DayNight.DarkActionBar">
      <!-- 自定义主题属性 -->
  </style>
  

  若必须使用NoActionBar主题，需手动在布局中添加Toolbar，并在Activity中设置为ActionBar：

  @Override
  protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);
      Toolbar toolbar = findViewById(R.id.toolbar);
      setSupportActionBar(toolbar);
  }
  

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