实用指南：无法打开包括文件: “QGLWidget”: No such file or directory

系列文章目录

文章目录

• 系列文章目录
• 前言
• 一、分析原因
• 二、解决办法

前言

当我们在使用osgQt时，编译器报错：
无法打开包括文档: “QGLWidget”: No such file or directory
解决 “无法打开包括文件: ‘QGLWidget’” 难题

一、分析原因

QGLWidget 找不到的疑问。在 Qt 5.15 中，QGLWidget 属于 QtOpenGL 模块，但从 Qt 5.4 开始，推荐使用 QOpenGLWidget，而 QGLWidget 可能在某些配置中未被包含。用户可能得在项目中添加 QtOpenGL 模块，或者如果使用的是较新的 Qt 版本，可能需要替换为 QOpenGLWidget，并相应调整 osgQt 的代码。
另外，查看用户给出的 osgQt 的 GraphicsWindowQt 头文件，发现其中包含 QGLWidget，因此得确保 Qt 的 OpenGL 模块被正确包含。在 Qt 工程文件中，需要添加 QT += opengl，并包含正确的头文件路径。
我这里使用的Qt5.15.2版本，

二、解决办法

1.如果使用QtCreator
QGLWidget 属于 Qt 的 OpenGL 模块，需在项目中明确启用该模块并正确包含头文件：

1. 确认 Qt 项目配置（.pro 档案）
   确保已添加 opengl 模块（关键修复）：
   pro
   QT += core gui widgets opengl # 必须包含opengl模块
2. 修正头文件包括方式
   在代码中使用完整路径包含 QGLWidget：
   cpp
   运行
   // 错误写法：#include （可能因Qt版本或路径问题找不到）
   // 正确写法：启用Qt模块路径具备
   #include <QtOpenGL/QGLWidget>

.pro 文件配备

QT       += core gui widgets opengl  # 新增opengl模块
TARGET = osgGISPluginsTest
TEMPLATE = app
DESTDIR = ./bin
# 配置OSG/osgEarth/osgQt头文件路径（根据实际安装路径修改）
INCLUDEPATH += \
E:/osg3.6.5/include \
E:/osgearth3.2/include \
E:/osgQt/include
# 配置库文件路径
LIBS += \
-LE:/osg3.6.5/lib \
-LE:/osgearth3.2/lib \
-LE:/osgQt/lib \
# OSG核心库
-losg -losgDB -losgViewer -losgGA -losgUtil \
# osgEarth库
-losgEarth -losgEarthUtil -losgEarthSymbology \
# osgQt库
-losgQt \
# 系统依赖库
-lopengl32 -lglu32
# 编译选项（Debug/Release区分）
CONFIG(debug, debug|release) {
LIBS += -losgd -losgDBd -losgViewerd -losgGAd -losgUtild \
-losgEarthd -losgEarthUtild -losgEarthSymbologyd
} else {
LIBS += -losg -losgDB -losgViewer -losgGA -losgUtil \
-losgEarth -losgEarthUtil -losgEarthSymbology
}

2.假如启用visual studio 2022
一定要加入opengl




四、最终验证与配置检查
osgEarth 3.2 源码编译 的库，而非高版本（如 3.3+），接口差异会导致构造函数不匹配。就是osgEarth 版本确认：确保使用的
Qt 模块验证：在 Qt Creator 的 “项目”->“构建”->“Qt 模块” 中，确认 opengl 模块已勾选。
头文件路径检查：在项目属性的 “包含目录” 中添加 Qt OpenGL 头文件路径（通常为 Qt安装目录/5.15.2/msvc2019_64/include/QtOpenGL）。
库文件链接：确保链接了 Qt5OpenGL.lib（Release 模式）或 Qt5OpenGLd.lib（Debug 模式）。
通过以上修正，所有编译器报错应全部解决，代码可正常初始化 osgEarth 地球并加载带 PBR 材质的 FBX 模型。核心修复点是适配 osgEarth 3.2 的图层构造接口和正确配置 Qt OpenGL 模块。