Android MaterialToolbar的app:menu属性作用及显示问题咨询

核心结论 #

app:menu并非仅用于Android Studio预览，它具备运行时加载菜单的能力，但生效有明确前提条件。

你遇到预览正常、运行不显示的原因 #

你碰到的问题，本质是两个关键前提没满足：

1. 你的Activity没有调用setSupportActionBar(toolbar)，将MaterialToolbar设置为Activity的ActionBar；
2. 你重写了onCreateOptionsMenu方法，但没有在方法内调用super.onCreateOptionsMenu(menu)——父类方法会自动读取app:menu的配置并完成菜单加载。

Android Studio的预览是直接解析布局文件属性，不依赖Activity的逻辑代码，所以哪怕没满足上述条件，预览也能显示菜单；但运行时必须依赖ActionBar的正确配置和菜单加载逻辑，否则app:menu的配置不会生效。

为什么不用tools命名空间 #

tools命名空间的属性是仅预览生效，编译后会被系统忽略；而app:menu属于AppCompat库的运行时属性，它本身就设计为可以在运行时生效，因此不能用tools命名空间替代。

app:menu的实际用途 #

• 无需编写Java代码，直接在布局中配置固定菜单，适合菜单不需要动态修改的场景；
• 在正确配置ActionBar的前提下，实现预览与运行时菜单展示一致，减少代码冗余；
• 可以配合app:popupTheme等属性，统一配置菜单的弹出样式，保持UI一致性。

补充说明 #

你后来通过重写onCreateOptionsMenu显示菜单，是因为这个方法是系统加载选项菜单的标准入口——不管有没有app:menu配置，只要在方法里通过getMenuInflater().inflate(R.menu.custom_menu, menu)加载菜单并返回true，就能显示。如果不重写这个方法，同时正确设置了setSupportActionBar(toolbar)，app:menu指定的菜单会被自动加载。

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