Apple Silicon架构M1 Mac安装GTK+出现#include报错如何解决

该报错本质是编译器/IDE无法识别GTK的头文件搜索路径，Apple Silicon架构的Macbrew默认安装路径和Intel架构不同，是该类问题的高发诱因，可按以下步骤修复：

步骤1：确认GTK安装状态，获取正确头文件路径 #

• 先确认安装状态：执行 brew list gtk+3（对应GTK3）或 brew list gtk4（对应GTK4），能正常输出文件列表则brew安装无异常；如果是脚本安装的GTK，找到你自定义的安装根目录即可。
• 执行pkg-config命令获取官方标准的头文件参数：
  GTK3执行：pkg-config --cflags gtk+-3.0
  GTK4执行：pkg-config --cflags gtk4
  输出内容中所有-I后缀的路径就是需要添加的头文件搜索路径，复制备用。
  注意：M1芯片Mac的brew默认安装路径为/opt/homebrew，不要直接复用网上Intel架构/usr/local前缀的路径配置

步骤2：配置IDE/编辑器的includePath #

以VS Code为例，其他编辑器/IDE操作逻辑一致：

• 打开项目根目录下.vscode文件夹内的c_cpp_properties.json文件
• 找到includePath配置项，将上一步复制的所有头文件路径依次添加，路径末尾加/**表示递归扫描子目录，参考配置如下：

{
    "configurations": [
        {
            "name": "Mac",
            "includePath": [
                "${workspaceFolder}/**",
                "/opt/homebrew/include/gtk-3.0/**",
                "/opt/homebrew/include/glib-2.0/**",
                "/opt/homebrew/lib/glib-2.0/include/**",
                "/opt/homebrew/include/pango-1.0/**",
                "/opt/homebrew/include/harfbuzz/**",
                "/opt/homebrew/include/cairo/**",
                "/opt/homebrew/include/gdk-pixbuf-2.0/**",
                "/opt/homebrew/include/atk-1.0/**"
            ],
            "compilerPath": "/usr/bin/clang",
            "cStandard": "c11",
            "cppStandard": "c++17"
        }
    ],
    "version": 4
}

• 保存文件后重启IDE的C/C++语言服务，报错即可消失。

步骤3：编译命令适配 #

如果是手动编译代码，直接在编译命令中嵌入pkg-config参数即可，不需要手动指定头文件路径：

• GTK3编译指令示例：gcc 你的代码文件.c -o 输出文件 pkg-config --cflags --libs gtk+-3.0``
• GTK4编译指令示例：gcc 你的代码文件.c -o 输出文件 pkg-config --cflags --libs gtk4``

额外排查项 #

• 如果执行pkg-config提示找不到gtk配置，执行echo $PKG_CONFIG_PATH确认是否包含brew的pkgconfig路径，M1下需要添加export PKG_CONFIG_PATH="/opt/homebrew/lib/pkgconfig"到~/.zshrc或~/.bash_profile中，执行source ~/.zshrc生效后再重试。
• 不要同时混用brew安装的GTK和脚本安装的GTK，会出现版本冲突，卸载其中一个后再操作：brew卸载命令为brew uninstall gtk+3 gtk4，脚本安装的GTK直接删除对应安装目录即可。

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