Android中如何彻底隐藏Toolbar中的返回按钮（Up按钮）

核心问题原因 #

你调用的setupActionBarWithNavController方法会覆盖你之前对ActionBar的返回按钮设置——Navigation组件会根据导航栈的层级和AppBarConfiguration的配置，自动决定是否显示返回按钮，这就是为什么你之前的设置无效。

解决方案（按优先级排序） #

1. 调整AppBarConfiguration，让Navigation不显示返回按钮

修改AppBarConfiguration的初始化，将所有Fragment都标记为顶级目的地，这样NavigationUI不会为它们显示返回按钮：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    binding = ActivityMainBinding.inflate(layoutInflater)
    setContentView(binding.root)

    val toolbar = binding.toolbar
    setSupportActionBar(toolbar)
    toolbar.title = "New Fragment Name"

    val navController = findNavController(R.id.nav_host_fragment_content_main)
    // 将你的三个Fragment ID传入setOf()，标记为顶级目的地
    appBarConfiguration = AppBarConfiguration(setOf(R.id.your_fragment_1, R.id.your_fragment_2, R.id.your_fragment_3))
    setupActionBarWithNavController(navController, appBarConfiguration)

    // 再次强制确保返回按钮隐藏
    supportActionBar?.setDisplayHomeAsUpEnabled(false)
    supportActionBar?.setDisplayShowHomeEnabled(false)
    toolbar.navigationIcon = null
}

2. 绕过NavigationUI的自动控制，手动管理Toolbar

如果不需要NavigationUI的联动功能，可以直接去掉setupActionBarWithNavController，完全手动控制Toolbar：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    binding = ActivityMainBinding.inflate(layoutInflater)
    setContentView(binding.root)

    val toolbar = binding.toolbar
    setSupportActionBar(toolbar)
    // 直接设置标题和隐藏返回按钮
    toolbar.title = "New Fragment Name"
    toolbar.navigationIcon = null
    supportActionBar?.setDisplayHomeAsUpEnabled(false)
    supportActionBar?.setDisplayShowHomeEnabled(false)

    val navController = findNavController(R.id.nav_host_fragment_content_main)
    // 移除setupActionBarWithNavController调用
}

3. 拦截NavigationUI对Toolbar的修改

如果必须保留setupActionBarWithNavController，可以通过监听导航事件，每次导航完成后强制隐藏返回按钮：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    binding = ActivityMainBinding.inflate(layoutInflater)
    setContentView(binding.root)

    val toolbar = binding.toolbar
    setSupportActionBar(toolbar)
    toolbar.title = "New Fragment Name"

    val navController = findNavController(R.id.nav_host_fragment_content_main)
    appBarConfiguration = AppBarConfiguration(navController.graph)
    setupActionBarWithNavController(navController, appBarConfiguration)

    // 监听导航切换，每次完成后强制隐藏返回按钮
    navController.addOnDestinationChangedListener { _, _, _ ->
        supportActionBar?.setDisplayHomeAsUpEnabled(false)
        supportActionBar?.setDisplayShowHomeEnabled(false)
        toolbar.navigationIcon = null
    }
}

4. XML布局中强制隐藏导航图标

在MaterialToolbar的XML中添加属性，默认隐藏导航图标：

<com.google.android.material.appbar.MaterialToolbar
    android:id="@+id/toolbar"
    android:layout_width="match_parent"
    android:layout_height="?attr/actionBarSize"
    app:navigationIcon="@null" />

额外检查点 #

• 检查所有Fragment的代码，确认没有调用setHasOptionsMenu(true)或者手动修改ActionBar返回按钮的逻辑
• 确认导航图中没有错误配置的层级，比如将MainActivity的nav_host设置为非顶级目的地

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