Windows 10下使用GTK C库找不到gtk/gtk.h的问题排查及解决求助

• VSCode环境配置错误：仅修改c_cpp_properties.json仅能解决编辑器语法提示的头文件识别问题，不会被实际编译环节调用的GCC/MSVC编译链读取，你添加的路径对最终编译无作用；同时混用msys2、vcpkg两个不同源的GTK路径会引发架构、版本冲突，反而会导致头文件匹配失败。
• Visual Studio IDE适配错误：vcpkg安装GTK后未执行全局集成命令，VS无法自动识别vcpkg的包路径；msys2安装的GTK为MinGW架构二进制，与VS使用的MSVC编译链不兼容，直接添加msys2的GTK路径无法被MSVC识别。
• GCC手动编译错误：Windows原生CMD/PowerShell不支持反引号、$()的命令替换语法，你在系统自带终端执行对应命令时，无法正确将pkg-config的输出参数传入GCC，才会出现参数解析错误；vcpkg安装的GTK默认未将pkg-config配置文件路径加入系统PKG_CONFIG_PATH`环境变量，因此pkg-config无法识别vcpkg安装的GTK版本。

请勿混用msys2和vcpkg的GTK资源，选择以下任一方案单独配置即可：

方案1：Msys2 + MinGW64 编译链（推荐新手使用） #

• 打开Msys2专属的MinGW64终端，不要使用系统原生CMD/PowerShell，执行命令安装依赖：
  pacman -S mingw-w64-x86_64-gcc mingw-w64-x86_64-gtk3 mingw-w64-x86_64-pkg-config
• 验证依赖：在MinGW64终端执行pkg-config --cflags --libs gtk+-3.0，确认能正常输出编译链接参数
• 编译代码直接在MinGW64终端执行以下命令，终端原生支持$()命令替换语法：
  gcc $(pkg-config --cflags gtk+-3.0) test.c -o test.exe $(pkg-config --libs gtk+-3.0)
• VSCode适配：将VSCode默认终端设置为MinGW64，c_cpp_properties.json仅需添加MinGW64路径下的GTK头文件目录即可，不要引入vcpkg相关路径。

方案2：Visual Studio + vcpkg 编译链 #

• 清空vcpkg已安装的GTK相关包，重新安装对应架构版本：
  vcpkg install gtk3:x64-windows gtk4:x64-windows
• 执行vcpkg全局集成命令，让Visual Studio自动识别vcpkg的包路径：
  vcpkg integrate install
• 打开VS创建C项目，编译架构选择与安装包一致的x64，无需手动添加头文件路径，VS会自动从vcpkg导入对应配置。
• 若需要让pkg-config识别vcpkg安装的GTK，新增系统环境变量PKG_CONFIG_PATH，值设置为你的vcpkg安装目录\installed\x64-windows\lib\pkgconfig即可。

内容的提问来源于stack exchange，提问作者Arthur Brackmann Pires