要使.ui文件被编译进程序，必须将其添加到.pro文件的FORMS列表或CMakeLists.txt中对应指令里，确保uic生成ui_xxx.h并由构建系统自动包含；绑定时需声明Ui命名空间、定义ui指针、在构造函数中调用setupUi()，且UI顶层widget类型须与C++基类严格一致。

直接添加 .ui 文件到项目里，不等于它就能被编译进程序——关键在是否触发 uic 工具生成 ui_*.h，以及类能否正确定位并使用这个头文件。

怎么让 Qt Creator 识别并编译 .ui 文件

Qt Creator 不会自动把任意 .ui 文件纳入构建流程。必须确保该文件出现在 .pro 文件的 SOURCES 或（更常见）FORMS 列表中。

• 右键项目 → “Add Existing Files…” → 选中 xxx.ui → 点击“Open”后，Qt Creator 通常会**自动把它加进 FORMS += xxx.ui** 行（若没加，手动补上）
• 如果用的是 CMake 项目，得在 CMakeLists.txt 中显式调用 qt_add_resources() 或 qt_add_executable() 并传入 xxx.ui，否则 uic 根本不会运行
• 添加完立刻按 Ctrl+B 构建一次，检查输出窗口有没有类似 uic xxx.ui -o ui_xxx.h 的日志；没有就说明没走通

UI 文件生成的头文件在哪？为什么 #include "ui_xxx.h" 报错

ui_xxx.h 默认不出现在源码目录，而是由 uic 输出到构建目录（比如 build-MyApp-Desktop_Qt_6_5_0_MinGW_64_bit-Debug/ui_xxx.h）。所以不能靠手动路径包含，而要依赖构建系统自动导出的 include 路径。

C++ Code Review Master

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

下载

• 确保 .pro 文件里有 UI_DIR = $$PWD/ui_generated 这类配置（可选，但推荐），这样所有 ui_*.h 都统一输出到指定子目录，便于管理
• 不要写 #include "./ui_generated/ui_xxx.h" —— 正确写法永远是 #include "ui_xxx.h"，因为构建系统会把 UI_DIR（或默认构建路径）加进编译器的 -I 参数
• 如果报 ui_xxx.h: No such file or directory，八成是构建目录被清过、或切换了 Kit 却没重新构建，先删掉整个 build-* 目录再全量构建一次

怎么把已有的 QWidget 类和新 UI 文件绑定

不是所有类都天生支持 UI 绑定。核心是三件事：声明命名空间、定义指针、构造时调用 setupUi()。

• 在类头文件（如 MyWidget.h）的 #include <QWidget> 后、类定义前加：
  namespace Ui { class MyWidget; }
• 在类私有成员里声明：
  Ui::MyWidget *ui;
• 在构造函数初始化列表中创建，并在函数体内调用：
  MyWidget::MyWidget(QWidget *parent) : QWidget(parent), ui(new Ui::MyWidget) { ui->setupUi(this); }
• 别忘了在析构函数里 delete ui;，否则内存泄漏

最常被忽略的一点：UI 文件里的顶层 widget 类型（QWidget / QDialog / QMainWindow）必须和你绑定的 C++ 类基类严格一致，否则 setupUi() 内部类型转换会失败，运行时可能崩溃或控件不显示。