Qt 6.5 OpenGL表面窗口无响应问题求助

你的代码存在几个关键问题，导致窗口无响应：

1. 错误的父类构造函数参数 #

QOpenGLWindow是QWindow的子类，不支持QWidget*类型的父对象，构造函数参数声明和实现都需要修改：

// mainwindow.h 中修改声明
MainWindow(QWindow *parent = nullptr);

// mainwindow.cpp 中修改实现
MainWindow::MainWindow(QWindow *parent) : QOpenGLWindow(parent)
{
    setSurfaceType(QWindow::OpenGLSurface);
}

2. 重写事件函数但未调用父类实现 #

你重写了resizeEvent和paintEvent，但没有调用QOpenGLWindow的父类实现，这直接打断了OpenGL窗口的正常渲染流程，导致窗口无法更新和响应。

• 最简单的解决方式：直接删除这两个事件函数的重写，QOpenGLWindow已经自带了对应的逻辑，会自动触发resizeGL和paintGL。
• 如果需要保留重写，必须在函数内调用父类方法：

void MainWindow::resizeEvent(QResizeEvent *event)
{
    QOpenGLWindow::resizeEvent(event);
}

void MainWindow::paintEvent(QPaintEvent *event)
{
    QOpenGLWindow::paintEvent(event);
}

3. Qt6 OpenGL 模块配置调整 #

Qt6中opengl模块已拆分，.pro文件可简化为以下内容，无需手动链接系统OpenGL库：

QT       = core gui opengl openglwidgets
greaterThan(QT_MAJOR_VERSION, 4): QT += widgets

TARGET = OpenGL
TEMPLATE = app

CONFIG += c++17

SOURCES += \
    main.cpp \
    mainwindow.cpp

HEADERS += \
    mainwindow.h

4. 补充基础渲染逻辑（可选） #

虽然不是无响应的直接原因，但空的渲染方法可以添加基础逻辑让窗口显示正常，比如在paintGL里实现清屏：

// 先在mainwindow.h中包含<QOpenGLFunctions>，并让类继承该类
class MainWindow : public QOpenGLWindow, protected QOpenGLFunctions
{
    // ... 原有代码 ...
};

// mainwindow.cpp中补充实现
void MainWindow::initializeGL()
{
    initializeOpenGLFunctions();
    glClearColor(0.2f, 0.3f, 0.3f, 1.0f);
}

void MainWindow::resizeGL(int w, int h)
{
    glViewport(0, 0, w, h);
}

void MainWindow::paintGL()
{
    glClear(GL_COLOR_BUFFER_BIT);
}

修复后的完整代码示例 #

mainwindow.h #

#ifndef MAINWINDOW_H
#define MAINWINDOW_H

#include <QOpenGLWindow>
#include <QOpenGLFunctions>

class MainWindow : public QOpenGLWindow, protected QOpenGLFunctions
{
    Q_OBJECT

public:
    MainWindow(QWindow *parent = nullptr);
    ~MainWindow();

protected:
    void initializeGL() override;
    void resizeGL(int w, int h) override;
    void paintGL() override;
};
#endif // MAINWINDOW_H

mainwindow.cpp #

#include "mainwindow.h"

MainWindow::MainWindow(QWindow *parent) : QOpenGLWindow(parent)
{
    setSurfaceType(QWindow::OpenGLSurface);
}

MainWindow::~MainWindow()
{
}

void MainWindow::initializeGL()
{
    initializeOpenGLFunctions();
    glClearColor(0.2f, 0.3f, 0.3f, 1.0f);
}

void MainWindow::resizeGL(int w, int h)
{
    glViewport(0, 0, w, h);
}

void MainWindow::paintGL()
{
    glClear(GL_COLOR_BUFFER_BIT);
}

.pro文件 #

QT       = core gui opengl openglwidgets
greaterThan(QT_MAJOR_VERSION, 4): QT += widgets

TARGET = OpenGL
TEMPLATE = app

CONFIG += c++17

SOURCES += \
    main.cpp \
    mainwindow.cpp

HEADERS += \
    mainwindow.h

修改后窗口即可正常显示并响应操作。

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