Windows下VS Code编译含gtk/gtk.h的CPP文件报错：文件不存在

Root Causes #

1. Incorrect Include Path Structure: The recursive wildcard (**) in your paths doesn't add D:\msys\mingw64\include\gtk-2.0 as a direct include path. When using #include <gtk/gtk.h>, the compiler expects a gtk directory (containing gtk.h) to exist directly under one of the include paths. Since gtk is a subdirectory of gtk-2.0, you need to add gtk-2.0 itself to the include paths.
2. Missing Dependency Management: You're not using pkg-config, the standard tool for resolving GTK's compile and link flags. Manually adding paths is error-prone, especially with multiple GTK versions and their dependencies (like GLib, Cairo).
3. Ambiguous GTK Version: Having GTK2, 3, and 4 installed means you need to explicitly specify which version to target—otherwise, the compiler might pick the wrong headers/libraries.

Fix IntelliSense Configuration #

Update your VS Code IntelliSense include paths to these specific entries for GTK2:

D:\msys\mingw64\include\gtk-2.0
D:\msys\mingw64\lib\gtk-2.0\include
D:\msys\mingw64\include\glib-2.0
D:\msys\mingw64\lib\glib-2.0\include
D:\msys\mingw64\include

These are the exact paths generated by pkg-config --cflags gtk+-2.0, ensuring all required headers are found.

Fix Compilation Command #

Stop using cpp.exe directly—use g++ (for C++) and leverage pkg-config to auto-generate correct flags:

1. Open the MSYS2 MinGW64 Terminal (not the default MSYS terminal) to ensure you're using the MinGW64 environment.
2. Run this command to compile your file:

   g++ your_file.cpp -o your_program $(pkg-config --cflags --libs gtk+-2.0)
   

   • Replace your_file.cpp with your actual source file name.
   • Replace gtk+-2.0 with gtk+-3.0 or gtk4 if you want to use GTK3/4 instead.

Why This Works #

• pkg-config --cflags outputs all -I (include path) flags needed for GTK and its dependencies.
• pkg-config --libs outputs all -l (library link) flags to link against GTK and required libraries.
• Using the MinGW64 terminal ensures you're using the correct compiler and library versions installed via MSYS2.

内容的提问来源于stack exchange，提问作者ענבר מימון