Qt Creator项目打不开、编译报错、UI修改无效，根本原因是环境链路未打通：安装时须勾选MinGW/Clang/GCC编译器、Qt库（如5.15.2或6.5.3）、Designer Tools；配置需在Kits中确认编译器和qmake路径；UI不更新需检查ui->setupUi(this)调用、ui_mainwindow.h包含及build目录清理。
Qt Creator 装完打不开项目、新建项目后编译报错、UI改了但运行没变化——这些问题基本都卡在「环境链路没打通」上，不是 Qt 本身难，而是安装时漏选组件或配置没生效。
Qt Creator 安装时必须勾选的三项
在线安装器（qt-unified-windows-x64-*.exe）启动后，关键不是版本号，而是组件勾选。只装 Qt Creator 本身是不够的，它只是个壳：
-
MinGW 11.2（Windows）或Clang（macOS）/GCC（Linux）：没有编译器，qmake或CMake就跑不起来 -
Qt 5.15.2或Qt 6.5.3（推荐选一个稳定版，别盲目追最新）：仅装 IDE 不带 Qt 库，#include <qapplication></qapplication>直接报红 -
Developer and Designer Tools：含Qt Designer和Qt Linguist，双击.ui文件进不了设计模式就说明这个没装
装完后别急着建项目，在 Tools → Options → Kits → Compilers 里确认编译器已识别；再看 Kits → Qt Versions 里有没有对应路径的 qmake.exe（Windows）或 qmake（macOS/Linux）。缺任意一项，新建项目都会卡在「No valid kits found」。
新建 Qt Widgets Application 后 UI 不生效的典型原因
你拖了按钮、改了文字，保存、编译、运行，界面还是空白或旧样子——大概率是没连上自动生成的 UI 类：
- 检查
mainwindow.cpp里是否有ui->setupUi(this);这行，且它在构造函数里被调用（不是注释掉、没写、或写在show()后面） - 确认
mainwindow.h包含了#include "ui_mainwindow.h"，且类声明里有Ui::MainWindow *ui; - 删掉
build-xxx目录重编译一次：Qt 的 MOC 和 UI 编译是增量式的，有时候改了.ui但没触发重新生成ui_mainwindow.h
如果仍无效，打开 Build & Run → Build Steps → Make，看命令行是否含 $(MAKE) -f Makefile（qmake）或 cmake --build（CMake）。没有，说明构建系统根本没走通。
信号槽连接失败：clicked() 没反应的硬伤点
按钮点了没反应，90% 是信号槽没连对，而不是逻辑写错了：
- 确保类头文件（如
mainwindow.h）第一行有Q_OBJECT宏，否则 MOC 不生成元对象代码，connect()会静默失败 - 检查
connect()语法是否匹配 Qt 版本：
Qt 5 写法：connect(ui->pushButton, &QPushButton::clicked, this, &MainWindow::onBtnClick);
Qt 6 强制要求用函数指针，不能用字符串（SIGNAL(clicked())已废弃） - 槽函数必须在
public slots:或private slots:区域内声明，不能只是普通成员函数 - 调试技巧：在
connect()后加一行qDebug() ，如果这行没输出，说明 connect 本身就没执行（比如写在 <code>if (false)里）
运行时报错 “The program has unexpectedly finished” 或闪退
这类问题往往发生在对象生命周期管理上，Qt 的父子机制是双刃剑：
- 用
new QLabel("xxx")创建控件时，**必须指定 parent**（比如传this），否则对象堆上分配但没人 delete，程序退出时可能崩溃或资源泄漏 - 不要手动
delete ui;以外的对象——Qt 的 parent-child 树会在父对象析构时自动清理子对象 - 检查
main()函数里是否用了QApplication app(argc, argv);（Widgets）或QGuiApplication（Quick），混用会导致初始化失败 - Windows 下若弹出「缺少 Qt5Core.dll」，说明没部署运行时库：用
windeployqt工具（和qmake同目录）补全 DLL，别手动复制
最易被忽略的是：Qt Creator 默认构建目录（build-xxx）里生成的可执行文件，依赖同目录下的 debug 或 release 子目录里的 DLL。直接双击运行会失败，必须从 Qt Creator 点「运行」按钮，或把所有 DLL 复制到 exe 同级目录再手动运行。
