Windows下CMake构建GTK4项目提示找不到gtk4-win32包如何解决

问题表现 #

在Windows平台基于MinGW工具链使用CMake构建GTK4项目时，编写的初始CMake配置如下：

cmake_minimum_required(VERSION 3.0.0)
project(tarost VERSION 1.0)

include(CTest)
enable_testing()

find_package(PkgConfig REQUIRED)
pkg_check_modules(GTK REQUIRED gtk4-win32)

aux_source_directory(src SRCDIR)
add_executable(tarost ${SRCDIR})
target_link_libraries(tarost ${GTK3_LIBRARY_DIRS})

set(CPACK_PROJECT_NAME ${PROJECT_NAME})
set(CPACK_PROJECT_VERSION ${PROJECT_VERSION})
include(CPack)

选择MinGW Makefiles作为CMake生成器执行配置时中断，核心报错为Package 'gtk4-win32', required by 'virtual:world', not found。但在MSYS64 Shell中手动执行pkg-config --libs --cflags gtk4-win32可以正常输出完整编译、链接参数，确认GTK4组件已正确安装。

根本原因 #

问题由两个独立错误共同导致：

1. 工具链环境不匹配：CMake当前调用的是D:/ProgFiles/MSYS64/usr/bin/路径下的gcc、g++、pkg-config程序，这是MSYS2原生模拟层的工具，默认pkg-config搜索路径仅覆盖MSYS2原生环境的包目录，不会扫描mingw64/lib/pkgconfig下的MinGW64平台包。只有在MSYS2的MinGW64专用终端中执行命令时，环境变量才会自动将MinGW64的工具、包路径设为最高优先级，才能正确找到gtk4-win32模块。
2. CMake脚本逻辑错误：pkg_check_modules定义的模块前缀为GTK，但后续链接时错误引用了GTK3_LIBRARY_DIRS变量；且LIBRARY_DIRS仅代表库搜索路径，不包含实际要链接的库列表、头文件路径、编译参数，就算变量名正确也无法完成正常编译链接。

修复方案 #

按以下步骤操作即可正常完成构建：

• 修正工具链调用逻辑：优先直接打开MSYS2的MinGW64终端，在该终端内进入项目build目录执行CMake命令，此时环境变量会自动配置为MinGW64工具链优先，pkg-config可正常识别GTK4包。如果需要在Windows终端/IDE中调用，需将D:\ProgFiles\MSYS64\mingw64\bin路径添加到系统环境变量Path的最前端，优先级高于MSYS2的usr/bin路径，避免调用到错误版本的工具。
• 修正CMakeLists.txt配置，替换为以下正确内容：

cmake_minimum_required(VERSION 3.16)
project(tarost VERSION 1.0 LANGUAGES C)

include(CTest)
enable_testing()

find_package(PkgConfig REQUIRED)
# 导入GTK4模块，自动生成可用的链接目标
pkg_check_modules(GTK4 REQUIRED IMPORTED_TARGET gtk4-win32)

aux_source_directory(src SRCDIR)
add_executable(tarost ${SRCDIR})
# 直接链接导入的目标，自动处理头文件、库路径、编译选项、依赖库，无需手动拆分变量
target_link_libraries(tarost PRIVATE PkgConfig::GTK4)

set(CPACK_PROJECT_NAME ${PROJECT_NAME})
set(CPACK_PROJECT_VERSION ${PROJECT_VERSION})
include(CPack)

• 清空原有build目录下的所有CMake缓存文件，重新执行配置、编译流程即可，不要复用之前错误配置生成的缓存。

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