MAUI Blazor应用Windows端任务栏图标合并时不显示问题求助

一、程序层面修复方案 #

1. 完善应用图标资源配置 #

任务栏合并时使用小尺寸图标（通常20-24px），当前清单中所有Logo复用同一icon.png，缩放后易出现显示异常。需补充适配不同尺寸的专属图标，并更新Package.appxmanifest：

<uap:VisualElements
  DisplayName="Display Lookup"
  Description="Display Lookup"
  Square150x150Logo="Resources\Images\icon150.png"
  Square44x44Logo="Resources\Images\icon44.png"
  SmallLogo="Resources\Images\icon24.png" <!-- 新增小尺寸图标配置 -->
  BackgroundColor="black">
  <uap:DefaultTile 
    Square71x71Logo="Resources\Images\icon71.png" 
    Wide310x150Logo="Resources\Images\iconWide.png" 
    Square310x310Logo="Resources\Images\icon310.png"  
    ShortName="DisplayLk"/> <!-- 短名称尽量简洁，避免缩放截断 -->
  <uap:LockScreen BadgeLogo="Resources\Images\BadgeLogo.png" Notification="badge"/>
</uap:VisualElements>

• 每个尺寸的图标需专门设计，禁止直接缩放大图标，防止边缘模糊或透明区域异常。
• ShortName设置为短名称（如“DisplayLk”），合并状态下更易显示完整。

2. 强制任务栏不合并（Windows API实现） #

若需强制应用不参与任务栏合并，可在Windows平台代码中通过P/Invoke设置窗口属性：
在Windows项目的Platforms\Windows\App.xaml.cs中添加以下代码：

using System.Runtime.InteropServices;
using Windows.UI.Xaml;

namespace YourAppName.WinUI;

public partial class App : MauiWinUIApplication
{
    protected override MauiApp CreateMauiApp() => MauiProgram.CreateMauiApp();

    protected override void OnLaunched(LaunchActivatedEventArgs args)
    {
        base.OnLaunched(args);
        // 获取主窗口句柄
        var window = Application.Current.Windows[0].Handler.PlatformView as Microsoft.UI.Xaml.Window;
        var hwnd = WinRT.Interop.WindowNative.GetWindowHandle(window);
        
        // 设置窗口不参与任务栏合并
        SetWindowLongPtr(hwnd, GWL_EXSTYLE, GetWindowLongPtr(hwnd, GWL_EXSTYLE) | WS_EX_APPWINDOW);
        ShowWindow(hwnd, SW_SHOW);
    }

    // P/Invoke 声明
    private const int GWL_EXSTYLE = -20;
    private const int WS_EX_APPWINDOW = 0x00040000;
    private const int SW_SHOW = 5;

    [DllImport("user32.dll", SetLastError = true)]
    private static extern IntPtr SetWindowLongPtr(IntPtr hWnd, int nIndex, IntPtr dwNewLong);

    [DllImport("user32.dll", SetLastError = true)]
    private static extern IntPtr GetWindowLongPtr(IntPtr hWnd, int nIndex);

    [DllImport("user32.dll")]
    private static extern bool ShowWindow(IntPtr hWnd, int nCmdShow);
}

该代码通过设置WS_EX_APPWINDOW扩展样式，强制窗口以独立应用身份显示在任务栏，避免被合并。

3. 确认窗口图标绑定正确 #

在MauiProgram.cs中确保窗口标题和图标设置无误：

builder.ConfigureMauiHandlers(handlers =>
{
#if WINDOWS
    handlers.AddHandler<Microsoft.Maui.Controls.Window, Microsoft.Maui.Handlers.WindowHandler>();
#endif
});

// 设置主窗口属性
var app = builder.Build();
var mainWindow = app.MainPage.Window;
mainWindow.Title = "Display Lookup";
#if WINDOWS
mainWindow.Icon = new Microsoft.Maui.Graphics.Platform.PlatformImage("Resources/Images/icon44.png");
#endif

二、设备端解决办法 #

如果程序层面无法立即修复，用户可通过以下系统设置缓解：

• 调整任务栏合并设置：保持为「任务栏满时合并」或「从不合并」，这是最直接的临时方案。
• 重置任务栏缓存：打开命令提示符，执行以下命令后重启资源管理器：

  taskkill /f /im explorer.exe && del /f /s /q %localappdata%\IconCache.db && start explorer.exe
  

• 调整任务栏图标大小：右键任务栏 → 「任务栏设置」→ 调整「任务栏图标大小」为默认或大尺寸，可能改善小图标显示效果。

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