WinUI 3(Windows App SDK)应用任务栏预览等默认图标修复方案

以下是覆盖全场景的自定义图标设置步骤，确保所有UI场景都显示你的品牌图标：

1. 完善项目基础图标配置 #

• 准备包含多尺寸的图标文件（推荐.ico格式，至少覆盖16x16、32x32、48x48、256x256像素），添加到项目的Assets文件夹，设置其生成操作为Content（打包应用）或Resource（非打包应用）。
• 针对不同项目类型配置：
  • 打包应用：打开Package.appxmanifest，切换到「视觉元素」标签，替换所有默认图标项（小图标、中等图标、大图标、方形/宽版Logo等）为你的自定义图标路径。
  • 非打包桌面应用：在App.xaml的Application节点中添加Icon属性，指定图标路径：

    <Application
        x:Class="YourAppName.App"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:local="using:YourAppName"
        Icon="ms-appx:///Assets/YourCustomIcon.ico">
    

2. 窗口级别强制设置图标 #

项目配置的图标可能无法自动同步到所有窗口场景，需在窗口初始化代码中手动绑定：

• 在主窗口的构造函数或OnLaunched方法中，获取AppWindow并设置图标：

  // 获取当前窗口对应的AppWindow
  var appWindow = Microsoft.UI.Windowing.AppWindow.GetFromWindow(Window.Current);
  // 设置图标路径
  appWindow.SetIcon("ms-appx:///Assets/YourCustomIcon.ico");
  

• 若使用第三方窗口库（如WinUIEx），直接调用窗口实例的SetIcon方法即可。

3. 自定义标题栏的图标处理 #

如果你的应用隐藏了默认标题栏并自定义绘制，需手动在标题栏UI中添加图标：

• 在标题栏的XAML布局里加入Image控件，绑定图标资源：

  <Grid x:Name="CustomTitleBar" Height="32" Background="{ThemeResource WindowCaptionBackground}">
      <Image Source="ms-appx:///Assets/YourCustomIcon.ico" Width="16" Height="16" Margin="8,0" VerticalAlignment="Center"/>
      <!-- 其他标题栏元素（如标题文本、最小化/最大化按钮） -->
  </Grid>
  

• 确保标题栏的拖动区域设置正确，避免遮挡图标。

4. 打包应用的额外验证 #

• 确认Package.appxmanifest中所有Logo字段（包括Square150x150Logo、Wide310x150Logo等）都已替换为自定义图标，这些字段直接影响Alt+Tab切换、任务栏缩略预览的图标显示。
• 清理项目缓存（删除bin和obj文件夹）后重新生成打包项目，避免旧图标缓存导致显示异常。

注意事项 #

• 图标文件必须包含多尺寸适配，否则在高DPI显示器或不同缩放级别下会显示模糊或 fallback 到默认图标。
• 若应用中嵌入了WinForms/WPF控件，需额外设置对应宿主窗口的图标（如WinForms窗口的Icon属性）。

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