Qt Creator新建项目失败的根源是Kit未配置或三组件不匹配，需检查Compiler、Qt Version和Debugger是否正确绑定并版本兼容。
Qt Creator 不是装完就能直接写 UI 的 IDE，它依赖底层 Qt 库和编译器协同工作。如果你刚点开 Qt Creator 就新建项目报错、界面空白、按钮拖不进去，大概率不是操作问题，而是套件（Kit）没配对。
为什么新建 Qt Widgets Application 后 build 失败？
最常见原因是：没有可用的 Kit，或 Kit 中的 Qt 版本、编译器、调试器三者不匹配。
- 打开
Tools > Options > Kits，检查 “Kits” 标签页下是否有带绿色对勾的条目 - 如果没有，先去 “Compilers” 页确认是否识别到
MinGW或MSVC；再在 “Qt Versions” 页确认是否添加了qmake路径（如C:\Qt\6.5.3\mingw_64\bin\qmake.exe） - Windows 下若只装了 Visual Studio，但没装“C++桌面开发”工作负载，
MSVC编译器会显示为 “Not found” - Qt 6.5+ 默认不带
Qt Widgets模块，安装时必须手动勾选，否则即使 Kit 显示正常，构建也会提示Unknown module: widgets
双击 mainwindow.ui 进不去设计模式？
这通常不是 Designer 坏了，而是当前文件没被识别为 UI 文件，或项目没用 qmake 构建系统。
- 右键
mainwindow.ui→ “Open With” → 确保选的是 “Design Mode”，而不是 “Text Editor” - 检查
.pro文件里是否有FORMS += mainwindow.ui—— 没这行，uic工具根本不会处理它 - 如果用了 CMake，需确认
CMakeLists.txt中调用了qt_add_resources或qt_add_executable并启用了 AUTOMOC/AUTORCC/AUTOUIC - UI 文件被意外设为只读（比如从压缩包解压出来），右键属性取消“只读”即可
ui->setupUi(this) 报红但能编译通过，怎么回事？
这是 Qt Creator 编辑器的索引滞后导致的假报错，不影响实际构建，但会干扰代码补全和跳转。
- 菜单栏点击
Projects > Build > Run qmake（或右键项目 → “Run qmake”） - 如果仍报红，尝试
Build > Clean All+Build > Rebuild All - 检查
ui_mainwindow.h是否生成在build-xxx目录下 —— 若没生成，说明uic没运行，根源还是.pro文件漏了FORMS - Qt 6 中若混用
Q_OBJECT和 C++20 modules，也可能触发此现象，建议暂避 modules
信号槽连接写对了，点击按钮却没反应？
90% 是对象生命周期或连接时机问题，不是语法错误。
- 确保
connect调用发生在ui->setupUi(this)之后，且接收对象（如this）还活着 - 使用新语法
connect(button, &QPushButton::clicked, this, &MainWindow::onButtonClicked)，避免旧语法字符串反射带来的拼写/大小写陷阱 - 如果槽函数是 private 或未加
Q_SLOT宏（Qt 6 可省略，但 Qt 5 需要），旧式连接会静默失败 - 控件在
ui中，但你又在代码里new QPushButton并 connect —— 实际界面上显示的是ui里的那个，新 new 的根本没 show
真正卡住新手的，从来不是“怎么拖按钮”，而是“为什么拖了看不见”“为什么连了不响应”“为什么报红却能跑”。这些都不是 Qt 本身的问题，而是 Kit、构建系统、编辑器索引、对象所有权之间没对齐。每次遇到异常，优先查 Kit 状态、.pro 内容、build 目录是否存在 ui_*.h，比重装 Qt 有效得多。
