Windows系统下如何修改Rust Macroquad框架的任务栏图标与窗口标题？

方法1：使用Macroquad内置配置项（推荐） #

Macroquad基于miniquad封装，其启动配置Conf结构体默认提供了窗口图标配置参数，多数用户未注意到该字段，无需额外引入依赖即可生效：

• 准备标准ICO格式图标，需包含16x16、32x32、48x48三种尺寸以适配标题栏、任务栏、Alt+Tab预览场景，不要直接修改图片后缀生成ICO，需使用图标转换工具生成标准文件。
• 在项目启动代码中自定义启动配置，示例如下：

use macroquad::prelude::*;

#[macroquad::main(build_window_conf)]
async fn main() {
    // 原有业务逻辑不变
    loop {
        clear_background(LIGHTGRAY);
        next_frame().await
    }
}

fn build_window_conf() -> Conf {
    Conf {
        window_title: "你的应用名称".to_string(),
        window_width: 1280,
        window_height: 720,
        // 传入ICO图标数据，路径相对于Cargo.toml根目录
        window_icon: Some(include_bytes!("assets/app_icon.ico").to_vec()),
        ..Default::default()
    }
}

• 配置完成后执行cargo clean清理旧构建缓存，再重新编译运行即可生效。

方法2：Windows平台手动调用WinAPI设置 #

如果方法1未生效，可通过WinAPI在运行时主动设置窗口图标，适配特殊场景：

1. 先在Cargo.toml中添加Windows平台专属依赖：

[target.'cfg(windows)'.dependencies]
winapi = { version = "0.3", features = ["winuser", "shellapi"] }
miniquad = "0.3"

2. 添加图标设置逻辑，在主函数启动时调用：

use macroquad::prelude::*;

#[cfg(windows)]
unsafe fn set_windows_icon() {
    use winapi::um::winuser::{SendMessageA, WM_SETICON, ICON_SMALL, ICON_BIG, LoadImageA, IMAGE_ICON, LR_LOADFROMFILE};
    use miniquad::window::native_handle;

    let hwnd = native_handle().hwnd as _;
    // 加载小尺寸图标：适配标题栏、小任务栏视图
    let small_icon = LoadImageA(
        std::ptr::null_mut(),
        "assets/app_icon.ico\0".as_ptr(),
        IMAGE_ICON,
        16,
        16,
        LR_LOADFROMFILE
    );
    // 加载大尺寸图标：适配大任务栏视图、Alt+Tab预览
    let big_icon = LoadImageA(
        std::ptr::null_mut(),
        "assets/app_icon.ico\0".as_ptr(),
        IMAGE_ICON,
        32,
        32,
        LR_LOADFROMFILE
    );
    SendMessageA(hwnd, WM_SETICON, ICON_SMALL as _, small_icon as _);
    SendMessageA(hwnd, WM_SETICON, ICON_BIG as _, big_icon as _);
}

#[macroquad::main(build_window_conf)]
async fn main() {
    #[cfg(windows)]
    unsafe { set_windows_icon(); }

    // 原有业务逻辑不变
    loop {
        clear_background(LIGHTGRAY);
        next_frame().await
    }
}

fn build_window_conf() -> Conf {
    Conf {
        window_title: "你的应用名称".to_string(),
        window_width: 1280,
        window_height: 720,
        ..Default::default()
    }
}

注意事项 #

• 确认winres配置的EXE图标和窗口配置的图标为同一套资源，避免出现资源管理器显示图标和运行时图标不一致的问题。
• 若调整后任务栏图标未更新，可尝试重启Windows资源管理器，或把生成的EXE移动到其他目录打开，避免Windows的图标缓存导致显示旧图标。

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