Android MenuItem标题修改失效：无法更新菜单项文本

这种情况我太懂了——明明断点都显示MenuItem的title已经改成"Orange"了，屏幕上却顽固地显示"Apple"，简直让人怀疑自己的眼睛😅。结合我踩过的坑，给你几个排查方向：

1. 先确认是不是用了自定义菜单布局 #

这是最常见的原因！如果你的菜单项设置了android:actionLayout属性（自定义了菜单的UI），直接调用menuItem.setTitle()只会修改MenuItem对象的title值，不会同步到自定义布局里的TextView上。

解决办法：找到自定义布局里的文本控件，直接修改它的内容：

@Override
public boolean onPrepareOptionsMenu(Menu menu) {
    MenuItem appleItem = menu.findItem(R.id.your_apple_menu_id);
    if (appleItem != null) {
        // 获取自定义布局的根View
        View customActionView = appleItem.getActionView();
        if (customActionView != null) {
            // 找到布局里的TextView（替换成你自己的id）
            TextView menuTitle = customActionView.findViewById(R.id.tv_menu_title);
            if (menuTitle != null) {
                menuTitle.setText("Orange");
            }
        } else {
            // 没有自定义布局的情况，直接修改MenuItem标题
            appleItem.setTitle("Orange");
        }
    }
    return super.onPrepareOptionsMenu(menu);
}

2. 检查onPrepareOptionsMenu的返回值 #

如果你的方法最后返回了false，系统会认为你不需要显示这个菜单，可能会忽略你的修改。确保最后返回super.onPrepareOptionsMenu(menu)或者true。

3. 排查是否被onCreateOptionsMenu覆盖 #

如果你在onCreateOptionsMenu里每次都重新设置了菜单项的标题为"Apple"，那onPrepareOptionsMenu的修改会被覆盖。比如这种错误写法：

@Override
public boolean onCreateOptionsMenu(Menu menu) {
    getMenuInflater().inflate(R.menu.your_menu, menu);
    // 这里又把标题设回Apple了！
    menu.findItem(R.id.your_apple_menu_id).setTitle("Apple");
    return true;
}

把onCreateOptionsMenu里的手动设置标题代码删掉，只保留菜单填充逻辑。

4. 外部修改时记得触发菜单刷新 #

如果是在onPrepareOptionsMenu之外的地方（比如按钮点击事件）修改菜单标题，必须调用invalidateOptionsMenu()来让系统重新调用onPrepareOptionsMenu：

// 比如点击按钮后修改菜单标题
yourButton.setOnClickListener(v -> {
    // 触发菜单重新准备
    invalidateOptionsMenu();
});

按照上面的步骤排查，大概率能解决问题——我之前就是因为用了自定义布局，折腾了半天才发现是没改布局里的TextView😂。

内容的提问来源于stack exchange，提问作者K. Rawls