如何将图标链接到Rust Windows应用并设置窗口类图标？

现有问题分析 #

在Rust开发Windows桌面应用时，通常会通过WNDCLASSW结构体定义窗口类，并通过其hIcon成员设置窗口类图标。目前常见的实现是从外部Icon.ico文件加载图标：

...
let hicon: HICON = LoadImageW(
    0 as HINSTANCE, 
    wide_null("Icon.ico").as_ptr(), 
    IMAGE_ICON, 0, 0, LR_LOADFROMFILE
) as HICON;

let hinstance = GetModuleHandleW(null_mut());

let mut wc: WNDCLASSW = std::mem::zeroed();
wc.lpfnWndProc = Some(window_proc);
wc.hInstance = hinstance;
wc.hIcon = hicon;
wc.lpszClassName = name.as_ptr();
...

这种方式存在明显缺陷：图标文件需随exe一同分发，若文件丢失，LoadImageW会返回NULL句柄，窗口将使用系统默认图标。我们需要将图标直接嵌入exe内部，同时确保任务栏显示的窗口类图标也同步更新。

解决方案步骤 #

1. 配置项目编译资源 #

在Cargo.toml中添加编译依赖，用于将图标嵌入exe：

[build-dependencies]
winres = "0.1"

然后创建build.rs文件，完成资源编译：

fn main() {
    let mut res = winres::WindowsResource::new();
    // 指定要嵌入的图标文件路径
    res.set_icon("Icon.ico");
    // 编译资源并嵌入到生成的exe中
    res.compile().unwrap();
}

若需要自定义资源ID或添加多个资源，可创建app.rc资源脚本文件：

> IDI_MAIN_ICON ICON "Icon.ico"

并改用cc crate编译rc文件：

[build-dependencies]
cc = "1.0"

fn main() {
    cc::Build::new().file("app.rc").compile("app.res");
}

2. 从exe资源中加载图标到窗口类 #

修改窗口类初始化代码，不再从外部文件加载，而是直接从当前进程的内嵌资源中读取图标：

use windows::Win32::UI::WindowsAndMessaging::{LoadIconW, MAKEINTRESOURCEW, IDI_APPLICATION};
use windows::Win32::System::LibraryLoader::GetModuleHandleW;
use windows::Win32::UI::WindowsAndMessaging::{WNDCLASSW, HICON};
use std::ptr::null_mut;

// 获取当前进程实例句柄
let hinstance = GetModuleHandleW(null_mut());

// 加载内嵌的图标资源
// 使用winres默认配置时，直接用IDI_APPLICATION即可；若用自定义rc，替换为你的资源ID（如IDI_MAIN_ICON）
let hicon: HICON = LoadIconW(
    hinstance,
    MAKEINTRESOURCEW(IDI_APPLICATION)
).unwrap_or_else(|_| {
    // 加载失败时 fallback 到系统默认图标
    LoadIconW(hinstance, IDI_APPLICATION).unwrap()
});

// 初始化窗口类
let mut wc: WNDCLASSW = std::mem::zeroed();
wc.lpfnWndProc = Some(window_proc);
wc.hInstance = hinstance;
wc.hIcon = hicon; // 将加载到的内嵌图标赋值给窗口类
wc.lpszClassName = name.as_ptr();

// 后续注册窗口类、创建窗口等逻辑...

如果需要指定图标大小，可改用LoadImageW实现更灵活的加载：

use windows::Win32::UI::WindowsAndMessaging::{LoadImageW, IMAGE_ICON, LR_DEFAULTCOLOR};

let hicon: HICON = LoadImageW(
    hinstance,
    MAKEINTRESOURCEW(IDI_APPLICATION),
    IMAGE_ICON,
    32, 32, // 指定32x32大小，可根据需求调整
    LR_DEFAULTCOLOR
).unwrap_or_else(|_| LoadIconW(hinstance, IDI_APPLICATION).unwrap());

3. 验证效果 #

编译项目后，exe文件将内嵌图标：

• 文件资源管理器中exe的图标会更新为你指定的图标
• 程序运行时，任务栏显示的窗口图标也会同步为该内嵌图标，无需额外携带外部图标文件

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