如何修改Windows任务切换器（Alt-Tab）中Tauri应用的显示图标？

核心问题原因 #

Windows的Alt-Tab任务切换器优先读取可执行文件本身嵌入的图标资源，和窗口标题栏、任务栏的图标加载逻辑不同。你遇到的Debug版CMD窗口图标正常，说明图标资源本身没问题，但主应用窗口的图标嵌入或关联环节出了问题。

具体修复步骤 #

1. 确认图标资源与配置路径 #

• 必须使用Windows兼容的ICO格式图标，推荐包含16x16、32x32、48x48、256x256等多尺寸，避免用仅含单一尺寸的PNG转ICO文件。
• 检查tauri.conf.json的配置，确保tauri.bundle.icon路径正确（相对于项目根目录），示例配置：

  "bundle": {
    "icon": ["icons/app-icon.ico", "icons/app-icon.png"]
  }
  

  注：Windows环境下ICO文件优先级高于PNG，务必保证ICO文件存在且路径无误。

2. 清理缓存并重新构建 #

Tauri构建缓存可能导致旧图标残留，执行以下操作彻底重建：

• 清理Rust和Tauri缓存：运行cargo clean和npm run tauri clean（根据包管理器替换为yarn/pnpm对应命令）。
• 构建生产版本：执行npm run tauri build，不要使用开发模式（dev模式下Tauri临时加载图标，不会嵌入到最终exe中）。

3. 手动在Rust代码中指定窗口图标 #

如果配置层面无法解决，直接在Rust后端为窗口强制绑定图标：
修改src-tauri/src/main.rs的窗口创建逻辑：

use tauri::{WindowBuilder, Manager, Icon};

fn main() {
  tauri::Builder::default()
    .setup(|app| {
      // 加载本地ICO文件，路径根据项目结构调整
      let app_icon = Icon::Raw(include_bytes!("../icons/app-icon.ico").to_vec());
      WindowBuilder::new(app, "main", tauri::WindowUrl::App("/".into()))
        .icon(app_icon)
        .build()?;
      Ok(())
    })
    .run(tauri::generate_context!())
    .expect("Failed to run Tauri application");
}

4. 验证Debug构建的主窗口图标 #

手动启动target/debug/[你的应用名称].exe（关闭Vite开发服务器），观察主窗口在Alt-Tab中的图标是否正常：

• 如果正常，说明生产构建的图标嵌入流程有问题，需检查构建脚本或升级Tauri版本；
• 如果仍异常，说明图标资源的尺寸或格式不符合Windows要求，重新生成标准ICO文件。

额外修复技巧 #

Windows图标缓存可能导致修改后不即时生效，执行以下命令清除缓存：

ie4uinit.exe -show

同时确保使用最新稳定版Tauri，旧版本可能存在图标嵌入的已知bug，执行npm update @tauri-apps/cli @tauri-apps/api完成升级。

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