Qt+CMake集成GStreamer报“glib.h不存在”错误求助

核心错误原因 #

你遇到的glib.h no such file or directory，是因为GStreamer的核心依赖glib的头文件路径没被添加到CMake的包含目录中——gst.h内部会引用glib的头文件，但你只配置了GStreamer自身的头文件路径，漏掉了glib的相关路径。另外你的CMake配置还有两个明显问题：

• 未定义${GSTREAMER_LIBRARIES}变量，链接阶段会找不到GStreamer的库文件
• 手动硬编码路径的方式不够健壮，CMake有官方的GStreamer查找模块可简化配置

修正后的CMake配置方案 #

方案1：使用CMake官方FindGStreamer模块（推荐） #

CMake自带FindGStreamer.cmake模块，能自动查找GStreamer及其依赖的头文件和库，无需手动硬编码路径。修改你的CMakeLists.txt如下：

# 若GStreamer不在系统默认路径，先设置根目录
set(GSTREAMER_ROOT_DIR "${CMAKE_SOURCE_DIR}/mingw_x86_64")
# 查找GStreamer核心库
find_package(GStreamer REQUIRED COMPONENTS core)

# 将GStreamer头文件路径添加到目标（推荐用target_include_directories而非全局include_directories）
target_include_directories(VideoTutorial PRIVATE ${GSTREAMER_INCLUDE_DIRS})

# 链接GStreamer库
target_link_libraries(VideoTutorial PRIVATE 
    Qt${QT_VERSION_MAJOR}::Widgets 
    Qt${QT_VERSION_MAJOR}::Network 
    ${GSTREAMER_LIBRARIES}
)

方案2：手动补全所有依赖路径（仅当Find模块失效时用） #

如果坚持手动指定路径，需要补全glib的两个关键头文件目录：

set(GSTREAMER_ROOT_DIR "${CMAKE_SOURCE_DIR}/mingw_x86_64")
# 补全glib的头文件路径
set(GLIB_INCLUDE_DIRS 
    "${GSTREAMER_ROOT_DIR}/include/glib-2.0"
    "${GSTREAMER_ROOT_DIR}/lib/glib-2.0/include"
)
set(GSTREAMER_INCLUDE_DIRS 
    "${GSTREAMER_ROOT_DIR}/include/gstreamer-1.0"
    ${GLIB_INCLUDE_DIRS}
)
# 手动指定GStreamer的库文件（根据实际文件名调整，比如libgstreamer-1.0.dll.a）
set(GSTREAMER_LIBRARIES "${GSTREAMER_ROOT_DIR}/lib/libgstreamer-1.0.dll.a")

target_include_directories(VideoTutorial PRIVATE ${GSTREAMER_INCLUDE_DIRS})

target_link_libraries(VideoTutorial PRIVATE 
    Qt${QT_VERSION_MAJOR}::Widgets 
    Qt${QT_VERSION_MAJOR}::Network 
    ${GSTREAMER_LIBRARIES}
)

关于Qt安装GStreamer失败的说明 #

Qt本身不提供GStreamer的安装包，所谓Qt集成GStreamer，是指Qt的多媒体模块调用系统中已安装的GStreamer库。你需要确保：

• 下载的GStreamer版本与Qt编译器完全匹配（你用的是MinGW x86_64，所以要下载GStreamer的MinGW64开发包，不能用MSVC版本）
• 安装GStreamer时勾选开发包（Development Install），否则会缺少头文件和静态库
• 若手动解压GStreamer包，要确保所有依赖库文件（比如glib、gobject的dll）能被程序找到（可将GStreamer的bin目录添加到系统PATH，或复制到程序输出目录）

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