Rust环境下GTK4运行报LINK1181错误：无法打开harfbuzz.lib文件求助

我是Rust新手，在新系统搭建Rust环境后运行GTK4程序时遇到问题。以下是我的测试代码（一个简单的空白窗口程序）：

use gtk4 as gtk;

use gtk::prelude::*;
use gtk::{glib, Application, ApplicationWindow};

const APP_ID: &str = "HelloWorld";

fn main() -> glib::ExitCode {
    // Create a new application
    let app = Application::builder().application_id(APP_ID).build();

    // Connect to the "activate" signal of `app`
    app.connect_activate(build_ui);

    // Run the application
    app.run()
}

fn build_ui(app: &Application) {
    // Create a window and set the title
    let window = ApplicationWindow::builder()
        .application(app)
        .title("Hello, World!")
        .build();

    // Connect the close button to end the program
    window.connect_close_request(|window| {
        window.close();
        glib::Propagation::Proceed
    });

    // Present window
    window.present();
}

这段代码在原系统运行正常，但新系统编译时出现错误：LINK : fatal error LNK1181: cannot open input file 'harfbuzz.lib'。奇怪的是，原系统里也找不到harfbuzz.lib文件。

我已经尝试过这些方法：

• 通过msys2重新安装GTK4
• 同步原系统的所有msys2包到新系统
• 卸载并重装Visual Studio Build Tools 2019
• 检查并确认PATH变量配置正确
• 从GitHub和msys2下载Harfbuzz，但未找到harfbuzz.lib文件

我怀疑这些方法可能有效，但不知道具体操作：

• 对比两个系统使用的链接器是否一致
• 手动编译Harfbuzz

希望能得到解决思路，谢谢。

解决方法 #

1. 统一链接器环境

原系统和新系统的链接器类型可能不一致，导致依赖查找逻辑不同：

• 在两个系统的终端分别执行 rustc -vV，查看输出里的host字段：
  • 若显示x86_64-pc-windows-msvc，说明用MSVC链接器
  • 若显示x86_64-pc-windows-gnu，说明用MinGW链接器
• 若不一致，通过rustup切换工具链统一：
  • 切换到MSVC：执行 rustup default stable-x86_64-pc-windows-msvc，确保已安装对应版本的Visual Studio Build Tools
  • 切换到MinGW：执行 rustup default stable-x86_64-pc-windows-gnu，确保msys2的MinGW环境（如mingw64）配置正常

2. 手动编译Harfbuzz生成库文件

如果链接器一致但仍找不到库，可手动编译：

1. 获取Harfbuzz源码包，解压后进入源码目录
2. 安装meson构建工具（msys2环境下执行 pacman -S meson）
3. 执行 meson setup build 创建构建目录
4. 进入build目录执行 ninja 编译
5. 编译完成后，build目录下会生成harfbuzz.lib（MSVC）或libharfbuzz.a（MinGW）
6. 将该库所在路径添加到系统LIB环境变量，或者在Rust项目根目录创建build.rs文件，添加：

fn main() {
    println!("cargo:rustc-link-search=native=/path/to/harfbuzz/build");
}

3. 确认msys2包的环境匹配

MSYS2的GTK4包分不同环境，确保安装的包对应当前链接器：

• 打开对应环境的终端（如MinGW64 Terminal），执行 pacman -S mingw-w64-x86_64-gtk4 安装对应版本的GTK4，避免在MSYS2 Terminal中安装导致环境不匹配

4. 检查pkg-config配置

Rust的gtk-rs依赖pkg-config查找库，确保其能正确定位Harfbuzz：

• 终端执行 pkg-config --libs harfbuzz，若输出正常则配置没问题；若报错，检查PKG_CONFIG_PATH：
  • MinGW环境下，确保该变量包含/mingw64/lib/pkgconfig
  • MSVC环境下，需安装pkg-config工具并配置对应库的.pc文件路径

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