Qt 4.8.7与Qt 5.15.2中GLEW和OpenGL代码差异及错误排查

首要关注核心差异 #

• Qt 5.x的OpenGL模块会隐式引入gl.h：和Qt4.8.7的QtOpenGL模块不同，Qt5的<QOpenGLWidget>、<QOpenGLContext>、<QOpenGLFunctions>等头文件，会直接或间接引入系统的gl.h，这是触发冲突的根本原因。
• 自动生成文件（如qt_generated/File4.cpp）的问题：这类文件由Qt工具链（uic/moc）生成，手动调整业务代码的头文件顺序无法解决，必须从Qt配置或依赖源头处理。

具体排查步骤 #

1. 定位隐式引入gl.h的源头 #

• 用编译器预处理器输出追踪：给编译命令添加-E（GCC）或/P（MSVC）参数，生成预处理后的完整代码，搜索#include <gl.h>，顺着包含链找到是哪个Qt头文件或业务文件先引入了它。
• 重点排查Qt5的OpenGL相关头文件：比如项目中是否引入了<QOpenGLFramebufferObject>、<QOpenGLBuffer>等，这些是Qt5里常见的隐式引入gl.h的源头。

2. 强制GLEW头文件优先引入 #

• 在所有Qt OpenGL头文件之前引入glew.h：最好放在项目的预编译头（PCH）最顶部，确保全局最先加载GLEW的头文件。同时可以添加宏定义：

  #define GLEW_STATIC // 静态链接GLEW时添加
  #define GLEW_NO_GLU // 不需要GLU时添加，避免额外头文件引入
  #include <GL/glew.h>
  

• 定义QT_NO_OPENGL_FUNCTIONS宏：在项目的.pro文件或预编译头中添加这个宏，阻止Qt自动引入<QOpenGLFunctions>及相关的gl.h。

3. 处理自动生成文件的依赖 #

• 检查生成文件对应的源文件：比如File4.cpp对应.ui或.h文件，看是否使用了Qt4遗留的OpenGL控件（如QGLWidget），换成Qt5的QOpenGLWidget后，调整对应文件的头文件顺序，确保glew.h在Qt OpenGL头文件之前。
• 调整qmake配置：在.pro文件中，将GLEW的头文件路径放在Qt OpenGL路径之前，示例：

  INCLUDEPATH += $$PWD/thirdparty/glew/include \
                 $$[QT_INSTALL_HEADERS]/QtOpenGL
  

4. 检查自定义OpenGL上下文封装 #

• 替换Qt4遗留的上下文类：原项目基于QGLContext的封装，在Qt5中换成QOpenGLContext后，避免调用context->functions()这类会触发Qt OpenGL函数引入的接口，改用GLEW获取OpenGL函数指针。
• 确保GLEW初始化时机：必须在OpenGL上下文激活之后、任何Qt OpenGL函数调用之前执行glewInit()，避免Qt提前加载gl.h。

内容的提问来源于stack exchange，提问作者Андрей Петров