Qt创建可缩放UI的最佳方法及代码实现，含Design模式代码同步问题解决

• 修改.ui文件后需手动保存，Qt Creator仅在ui文件保存后才会调用uic工具生成新的头文件
• 清理旧构建缓存：依次点击菜单栏「构建」-「清理项目」-「运行qmake」，再重新构建项目即可解决绝大多数旧代码残留问题
• 若仍有残留，手动删除项目根目录下的build-项目名-xxx构建输出文件夹，再重新构建即可
• 若使用了控件自定义提升功能，需检查提升的类名、头文件路径是否配置正确，错误的提升配置会导致uic生成失败，头文件停止更新
  注意：禁止手动修改ui_xxx.h文件，所有ui相关改动都应该在Design模式或.ui文件的XML源码中完成，手动修改的内容会在下次uic生成时被覆盖

Qt Widget项目实现自适应缩放UI无需额外第三方组件，使用Qt原生功能即可完成，核心技术点如下：

• 布局管理器：所有控件必须放入QHBoxLayout/QVBoxLayout/QGridLayout等布局中，禁止使用固定像素坐标摆放控件
• 尺寸策略QSizePolicy：为不同控件配置合适的拉伸、收缩规则，控制窗口缩放时各控件的尺寸变化逻辑
• 高DPI适配：Qt 5.6及以上版本开启内置高DPI缩放支持，适配不同分辨率、不同缩放比例的屏幕

可缩放UI代码示例 #

main.cpp 开启高DPI适配 #

#include "mainwindow.h"
#include <QApplication>

int main(int argc, char *argv[])
{
    // 开启高DPI自动缩放
    QCoreApplication::setAttribute(Qt::AA_EnableHighDpiScaling);
    // 高DPI下图标自动适配
    QCoreApplication::setAttribute(Qt::AA_UseHighDpiPixmaps);
    QApplication a(argc, argv);
    MainWindow w;
    w.show();
    return a.exec();
}

mainwindow.cpp 自适应布局实现 #

#include "mainwindow.h"
#include <QVBoxLayout>
#include <QHBoxLayout>
#include <QPushButton>
#include <QLabel>
#include <QLineEdit>

MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
{
    // 设置窗口最小尺寸，避免缩放过小导致控件重叠
    setMinimumSize(800, 600);
    QWidget *centralWidget = new QWidget(this);
    setCentralWidget(centralWidget);

    // 全局主布局
    QVBoxLayout *mainLayout = new QVBoxLayout(centralWidget);
    mainLayout->setContentsMargins(24, 24, 24, 24);
    mainLayout->setSpacing(16);

    // 输入行布局
    QHBoxLayout *inputLayout = new QHBoxLayout();
    QLabel *inputLabel = new QLabel("用户名：", this);
    QLineEdit *inputEdit = new QLineEdit(this);
    inputLayout->addWidget(inputLabel);
    inputLayout->addWidget(inputEdit);
    // 输入框占该行剩余空间
    inputLayout->setStretch(1, 1);
    mainLayout->addLayout(inputLayout);

    // 内容展示区
    QLabel *contentArea = new QLabel("自适应内容区域", this);
    contentArea->setStyleSheet("background: #f5f5f5; border: 1px solid #ddd; border-radius: 4px;");
    contentArea->setAlignment(Qt::AlignCenter);
    // 设置内容区可双向拉伸
    contentArea->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Expanding);
    mainLayout->addWidget(contentArea);
    // 内容区占窗口剩余全部空间
    mainLayout->setStretch(1, 1);

    // 按钮区布局
    QHBoxLayout *btnLayout = new QHBoxLayout();
    QPushButton *confirmBtn = new QPushButton("确认", this);
    QPushButton *cancelBtn = new QPushButton("取消", this);
    // 占位符将按钮挤到右侧
    btnLayout->addStretch(1);
    btnLayout->addWidget(confirmBtn);
    btnLayout->addWidget(cancelBtn);
    mainLayout->addLayout(btnLayout);
}

如果使用Design模式开发，无需手动编写布局代码：选中窗口空白区域，右键选择「布局」-「垂直/水平/网格布局」给窗口设置全局布局，再给子区域设置对应布局即可，所有布局参数都可以在右侧属性面板中配置

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