使用 Rust 调用 Windows API（Rust winapi 入门教程）

什么是 winapi？

winapi 是一个由社区维护的 Rust crate，它为 Windows 操作系统的原生 API 提供了完整的绑定（bindings）。这意味着你可以像在 C/C++ 中那样调用 Windows 函数，但享受 Rust 的类型安全和零成本抽象。

第一步：创建新项目并添加依赖

首先，确保你已安装 Rust 工具链（可通过 rustup 安装）。然后在终端中运行：

cargo new rust_winapi_democd rust_winapi_demo

接着，编辑 Cargo.toml 文件，添加 winapi 依赖：

[dependencies]winapi = { version = "0.3", features = ["winuser", "libloaderapi"] }

注意：我们启用了 winuser 和 libloaderapi 功能，因为它们分别包含用户界面函数（如 MessageBox）和动态库加载函数（如 GetProcAddress）。你可以根据需要启用其他功能，比如 processenv（环境变量）、handleapi（句柄操作）等。

第二步：编写第一个 Windows API 调用

让我们从最经典的 “Hello, World!” 弹窗开始——使用 MessageBoxW 函数。

use winapi::um::winuser::{MessageBoxW, MB_OK};use winapi::shared::ntdef::LPCWSTR;use std::ffi::OsStr;use std::os::windows::ffi::OsStrExt;fn to_wide(s: &str) -> Vec {    OsStr::new(s).encode_wide().chain(std::iter::once(0)).collect()}fn main() {    let title = to_wide("Rust WinAPI 示例");    let message = to_wide("你好，Windows！");    unsafe {        MessageBoxW(            std::ptr::null_mut(),            message.as_ptr(),            title.as_ptr(),            MB_OK,        );    }}

这段代码做了以下几件事：

• 导入 MessageBoxW 和 MB_OK 常量；
• 定义辅助函数 to_wide，将 Rust 字符串转换为 Windows 所需的 UTF-16 宽字符（以 null 结尾）；
• 在 unsafe 块中调用 MessageBoxW，因为 Windows API 不是内存安全的，Rust 要求显式标记。

运行程序：

cargo run

你应该会看到一个标准的 Windows 消息框弹出！

第三步：理解 unsafe 与错误处理

由于 Windows API 是 C 风格的接口，Rust 无法保证其安全性，因此所有调用都必须包裹在 unsafe 块中。但这并不意味着你的整个程序就不安全了——你只需确保传入的参数合法、指针有效即可。

此外，许多 Windows 函数会返回错误码（如 GetLastError()）。你可以结合 winapi::um::errhandlingapi::GetLastError 来进行错误诊断。

总结

通过本教程，你已经学会了如何在 Rust 中使用 winapi crate 调用 Windows API。这项技能对于开发系统工具、驱动程序、桌面应用或性能敏感型软件至关重要。记住，Rust winapi 提供了对底层系统的完全控制，同时保留了 Rust 的安全优势。

如果你想深入学习，建议查阅 winapi 官方文档 和 Microsoft 的 Windows API 参考。

掌握 Windows API绑定 和 Rust系统编程，你将能在 Windows 平台上构建高效、可靠的原生应用。现在，就去尝试调用更多 API 吧！