Windows下Qt开发四大坑：编译器未配导致构建失败；.pri路径缺$$PWD致头文件丢失；UI未设布局使控件不响应；信号槽用老语法引发运行时静默断连。
安装时选错编译器套件，项目根本跑不起来
Windows 上最常踩的坑就是装了 Qt Creator 却没配对编译器——比如只装了 Qt 5.15.2，但没勾选 MinGW 8.1.0 64-bit 或 MSVC 2019 64-bit。结果新建项目后点构建，直接报 Cannot find compiler "mingw" in PATH 或 No valid kits found。
解决方法很简单：
- 重装时在组件选择页，务必展开
Qt→Qt 5.15.2→ 勾选带编译器标识的子项（如MinGW 8.1.0 64-bit） - 安装完别急着写代码，先打开
工具 → 选项 → 构建与运行 → 编译器，确认列表里有识别到的编译器 - 再进
Kit页，检查是否自动生成了 Kit（名称含Desktop Qt 5.15.2 MinGW 64-bit这类字样），且编译器、Qt 版本、调试器三项都打钩
如果 Kit 显示黄色感叹号，说明某一项缺失或路径失效——常见原因是安装路径含中文或空格，比如 C:\我的Qt\，必须重装到纯英文路径如 C:\Qt\。
.pro 文件里 include .pri 路径写错，头文件“消失”
用 .pri 管理模块时，include(core/core.pri) 看似合理，实际会导致 Qt Creator 左侧项目视图里 core.h 不显示，甚至编译报 core.h: No such file or directory。根本原因是 .pri 内部的 HEADERS += core.h 是相对当前 .pri 所在目录解析的，而 include() 的路径写法没把上下文锚定住。
正确写法只有两个关键点：
- 在
.pro中用include($$PWD/core/core.pri)——$$PWD指向.pro所在目录，确保路径绝对可靠 - 在
core.pri中写HEADERS += $$PWD/core.h和SOURCES += $$PWD/core.cpp—— 此时$$PWD指向core.pri自身所在目录，和.pro无关
漏掉任一个 $$PWD，就可能让文件在工程视图中“隐身”，或者编译时找不到源码。这不是 Qt 版本问题，是 qmake 解析机制决定的。
UI 设计器里拖控件不生效，布局管理器被忽略
新手拖个 QPushButton 到窗体上，发现它悬浮不动、不能随窗口缩放，右键也没“布局”菜单——大概率是没给顶层 widget 设置布局。Qt Designer 的布局不是自动应用的，必须手动触发。
操作步骤很具体：
- 选中窗体最外层的空白区域（点击窗体边缘灰色区域，状态栏应显示
Widget或你设的类名） - 右键 →
排列布局→ 选垂直布局或网格布局（别选“无布局”） - 再拖控件进去，它们才会被布局管理器接管，响应 resize 和 spacing 设置
如果已经拖了控件再加布局，Qt 默认会把所有已有控件塞进新布局；但若之前手动调过 setGeometry() 或设过 fixedSize，布局可能失效，得删掉那些硬编码尺寸再试。
信号槽用老式宏语法，编译通过但运行崩溃
connect(ui->btn, SIGNAL(clicked()), this, SLOT(onClick())); 这种写法在 Qt 5.14+ 仍能编译，但一旦 onClick() 函数签名改了（比如加了个参数），运行时就会断开连接却不报错，点击按钮毫无反应——调试器也抓不到异常。
现代写法强制编译期检查，出错立刻暴露：
- 确保类声明里有
Q_OBJECT宏，且头文件已#include <QObject> - 用函数指针语法：
connect(ui->btn, &QPushButton::clicked, this, &MainWindow::onClick); - 如果提示
no matching function for call to 'connect'，八成是onClick声明在private slots:里但没加Q_SLOT，或者参数类型不匹配（比如想连textChanged(const QString&)却写了textChanged(QString)）
Qt Creator 有时会自动补全老式语法，尤其从 UI 文件生成槽函数时。务必手动改成现代写法，这是最省调试时间的习惯。
真正卡住人的往往不是某个功能不会用，而是错误被静默吞掉：Kit 配置失败却不提示、.pri 路径错却仍能编译、布局没设却看起来“能用”。盯住输出面板里的第一行警告，比反复试错快得多。
