将Visual Studio中基于Qt4的QWizard应用移植到Qt5后的问题

嘿，我之前刚好折腾过VS环境下Qt4转Qt5的项目，尤其是用QWizard的向导程序，给你分享下踩过的坑和关键步骤，应该能解决你的渲染问题：

Qt5最核心的变化是把原QtGui模块拆分成了Gui和Widgets两个模块，QWizard属于Widgets模块，这是很多渲染问题的根源：

• 把所有Qt4风格的头文件引用替换：比如#include <QtGui/QWizard>改成#include <QWizard>（或者<QtWidgets/QWizard>），同理QDialog、QPushButton这些原属QtGui的控件，头文件都要调整到QtWidgets模块下。
• 检查VS项目的链接库：移除Qt4的QtGui.lib/QtGuid.lib，添加Qt5的Qt5Widgets.lib（Debug版对应Qt5Widgetsd.lib），同时确保Qt5Core.lib/Qt5Cored.lib是Qt5版本的。

因为你是手动在VS里配置MOC，Qt5的MOC路径和参数都有变化：

• 更新MOC的路径：指向Qt5安装目录的bin文件夹，比如C:\Qt\5.15.2\msvc2019_64\bin\moc.exe，别再用Qt4的MOC了。
• 调整MOC的预定义宏：把原来的-DQT_GUI_LIB改成-DQT_WIDGETS_LIB，如果还有其他Qt4的宏（比如-DQT3_SUPPORT），直接删掉。
• 清理旧的MOC生成文件：把之前Qt4生成的moc_*.cpp文件删掉，让Qt5的MOC重新生成，避免编译冲突。

这部分是重点，针对你提到的大量渲染异常，逐一排查：

• 样式表兼容性问题：Qt4的QWizard样式表在Qt5里经常失效，比如标题栏、页面边框的样式。先临时注释掉所有自定义样式表，用Qt5默认样式测试，如果渲染正常，再逐段调整样式表——比如Qt5里QWizard::title的选择器可能需要配合QWizardPage一起调整，或者改用QWidget的通用样式。
• 高DPI适配问题：Qt5默认开启高DPI支持，但Qt4没有，如果你在高分辨率显示器上运行，很容易出现控件错位、字体模糊。在main函数开头添加两行代码：

  QApplication::setAttribute(Qt::AA_EnableHighDpiScaling);
  QApplication::setAttribute(Qt::AA_UseHighDpiPixmaps);
  

  （Qt5.6及以上版本支持，如果你用的是更早的Qt5版本，可能需要手动处理缩放）
• 布局兼容性问题：Qt5对布局的约束更严格，Qt4里松散的布局在Qt5里会导致控件重叠/显示不全。检查每个QWizardPage的布局：
  • 把Qt4的setMargin()改成Qt5推荐的setContentsMargins()，明确设置上下左右的边距。
  • 确保布局的spacing属性设置合理，没有控件脱离布局（可以用VS的Qt Designer插件打开ui文件检查，或者代码里打印布局的状态）。
• 自定义绘图代码适配：如果你的项目重写了QWizard或QWizardPage的paintEvent，Qt5的QPainterAPI有细微变化，比如setRenderHint的参数、坐标系的原点，要检查这些代码是否适配Qt5的逻辑。

• 信号槽语法升级：虽然Qt5兼容Qt4的旧SIGNAL/SLOT语法，但推荐改用新的编译期检查语法，比如把：

  connect(btnNext, SIGNAL(clicked()), this, SLOT(onNextClicked()));
  

  改成：

  connect(btnNext, &QPushButton::clicked, this, &MyWizard::onNextClicked);
  

  这样能提前发现拼写错误或者参数不匹配的问题，避免运行时崩溃。
• 清理Qt4残留：删除项目里的Qt4相关的资源文件（qrc编译的旧文件）、临时编译文件，确保整个项目都是用Qt5的工具链编译的。

按照这个步骤走，应该能解决大部分渲染问题，如果还有特定的异常，可以把具体的现象贴出来再细化排查~

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