.NET MAUI导航栏返回按钮图标修改问题

阿华AIGC实验室

2026-4-21

嘿，我完全懂你想单独修改导航栏返回按钮图标的需求——用TitleView折腾半天没达到预期确实挺头疼的，其实不用动整个TitleView，有几种更直接的方法能精准修改这个按钮的图标，分两种常见导航场景给你说说：

一、使用NavigationPage导航时的修改方法

1. 全局统一修改返回按钮图标

如果想让整个应用的返回按钮都用自定义图标，直接在App.xaml.cs的构造函数里设置就行：

public App()
{
    InitializeComponent();
    // 指定自定义返回图标（确保图片已添加到Resources/Images，Build Action设为MauiImage）
    NavigationPage.BackButtonIcon = "custom_back_icon.png";
    MainPage = new NavigationPage(new YourMainPage());
}

2. 单个页面单独修改

要是只需要某一个页面的返回按钮用不同图标，在目标页面的构造函数里设置：

public YourDetailPage()
{
    InitializeComponent();
    // 仅当前页面生效的自定义返回图标
    NavigationPage.SetBackButtonIcon(this, "custom_detail_back.png");
}

二、使用Shell导航时的修改方法

1. 单个页面单独配置

在目标页面的XAML里，通过Shell.BackButtonBehavior直接指定图标：

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="YourApp.YourDetailPage">
    <!-- 配置返回按钮图标 -->
    <Shell.BackButtonBehavior>
        <BackButtonBehavior IconOverride="custom_shell_back.png" />
    </Shell.BackButtonBehavior>

    <!-- 页面内容区域 -->
    <StackLayout>
        <!-- ... -->
    </StackLayout>
</ContentPage>

2. 全局统一设置Shell返回按钮图标

想让所有Shell页面的返回按钮都用同一个图标，在AppShell.xaml里全局配置：

<Shell xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
       xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
       x:Class="YourApp.AppShell">
    <!-- 全局Shell返回按钮图标 -->
    <Shell.BackButtonBehavior>
        <BackButtonBehavior IconOverride="global_shell_back.png" />
    </Shell.BackButtonBehavior>

    <!-- Shell的路由和页面配置 -->
    <!-- ... -->
</Shell>