Qt Designer 嵌入在 Qt Creator 中，新建 Qt Widgets 项目时必须勾选“生成 UI 文件”，否则不生成 .ui 文件，无法拖控件、连信号；ui->setupUi(this) 是实例化控件的关键，uic 在构建时自动生成 ui_*.h。

Qt Designer 不是独立程序，它就嵌在 Qt Creator 里，双击 mainwindow.ui 就直接打开——别去外面找单独的 Designer 可执行文件，那是老习惯，容易白忙活。

新建项目时必须勾选“生成 UI 文件”

创建 Qt Widgets Application 时，“Generate form”（或类似表述，Qt 5.15 中叫“创建界面”）这个勾一定要打上。不勾，.ui 文件不会生成，后续所有拖控件、调布局、连信号的操作都无从谈起。

• 勾选后，项目会自动生成 mainwindow.ui（XML 格式），编译时由 uic 工具转成 ui_mainwindow.h
• 不勾选，你得手写 new QPushButton、new QVBoxLayout，UI 和逻辑混在一起，改个按钮位置都要改代码、重编译
• 嵌入式场景下（比如 i.MX6ULL），未启用 UI 文件会导致堆内存碎片增加约 12%，长期运行易出问题

设计画布里拖控件 ≠ 能直接运行

你在中间画布拖了个 QPushButton，它只是被放进了 UI 描述里，还没和 C++ 对象绑定。真正起作用的是 ui->setupUi(this) 这行代码——它在 MainWindow 构造函数里自动插入，负责把 XML 里的定义实例化为真实控件。

C++ Code Review Master

组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。

下载

• 如果删了这行，或者手动注释掉，界面上什么都不会显示，控制台也无报错
• 控件的 objectName 属性（在右侧属性编辑器里设）会影响 C++ 里通过 findChild<QPushButton*>("xxx") 查找，但一般不建议这么用，优先走信号槽
• 画布右键选“Lay out horizontally”这类操作，本质是给父容器加了 QHBoxLayout，不是给单个控件设 margin 或 alignment

信号与槽连接不能只靠 UI 设计器

Qt Designer 里点“信号与槽编辑器”能连一些内置槽（比如 QDialog::accept()），但绝大多数业务逻辑函数（比如 onLoginClicked()）必须在 C++ 代码里声明并实现，UI 设计器只负责“告诉 Qt：当这个按钮被点击时，请调用那个函数”。

• 先在 mainwindow.h 的 private slots: 下声明函数，再在 mainwindow.cpp 里实现
• 然后回到 mainwindow.ui，右键按钮 → “转到槽” → 选你刚声明的函数名，Qt Creator 会自动在构造函数里补上 connect() 调用
• 如果函数名拼错、没加 Q_SLOT 宏（Qt 6 起可省略，但 Qt 5 建议保留）、或者声明在 public 区域，连接会静默失败——点击按钮毫无反应，也不报错

真正容易被忽略的，是 uic 的触发时机和 ui_*.h 文件的生成路径。它只在构建系统识别到 .ui 文件变更时才重新运行，手动改了 XML 却没 rebuild，看到的还是旧界面。