Qt Creator新建项目无法运行的根本原因是未正确关联Qt版本与编译器链，需在“工具→选项→构建和运行”中配置有效的qmake路径，并确保Kit同时绑定编译器、Qt版本和调试器；若UI设计界面打不开，则需确认项目含.pro或CMakeLists.txt且正确识别为Qt项目；信号槽失效常因缺失Q_OBJECT宏、槽函数位置错误或connect调用过早；修改.ui后需重新构建以更新ui_*.h文件。
Qt Creator 不是“装完就能直接写 UI”的 IDE，它依赖正确配置的 Qt 版本和编译器链。新手卡在第一步，往往不是不会拖控件，而是根本跑不起来一个窗口。
为什么新建项目后点击运行没反应？
常见现象：qmake 报错找不到 Qt5Core、Qt6Widgets，或构建时提示 Unknown module(s) in QT: widgets。
根本原因：Qt Creator 检测到了编译器（如 MinGW 或 MSVC），但没关联上对应版本的 Qt 库。
- 打开
工具 → 选项 → 构建和运行 → Qt 版本，确认已添加有效的qmake.exe路径（例如C:\Qt\6.5.0\mingw_64\bin\qmake.exe） - 再进
构建套件（Kits）标签页，检查自动创建的 Kit 是否同时绑定了「编译器」+「Qt 版本」+「调试器」；缺一不可 - 若手动添加过 Kit，注意
Qt 版本下拉框必须选中非空项，灰色不可选状态 = 无效 Kit
双击 mainwindow.ui 打不开设计界面？
现象：文件被当作纯文本打开，左侧没有组件栏，顶部菜单无 编辑模式/设计模式 切换按钮。
本质是文件关联丢失或项目未识别为 Qt Widgets 项目。
- 确认项目根目录下存在
.pro文件（Qt 5）或CMakeLists.txt中启用了find_package(Qt6 REQUIRED COMPONENTS Widgets)（Qt 6） - 右键
mainwindow.ui→打开方式 → Qt Designer（临时救急） - 更彻底：关闭项目 → 删除
build-xxx和xxx.pro.user文件 → 重新打开.pro文件让 Qt Creator 重载配置
connect() 写了但按钮点击没响应？
这是新手最常掉坑的地方——信号槽连上了，但槽函数压根没执行。
- 确保类声明里写了
Q_OBJECT宏（且在class行下方第一行），否则 MOC 不生成元对象代码 - 槽函数声明必须在
public slots:或private slots:区域内，不能写在public:下 - 连接语句要放在
ui->setupUi(this)之后，否则ui->pushButton还是空指针 - Qt 6 默认使用新语法
connect(ui->pushButton, &QPushButton::clicked, this, &MainWindow::onBtnClick)；旧语法SIGNAL(clicked())已废弃，编译会报错
改了 .ui 文件，代码里却读不到新控件？
现象：UI 上加了个 QLineEdit 并设 objectName 为 lineEditPwd，但在 mainwindow.cpp 里写 ui->lineEditPwd 提示 “no member named 'lineEditPwd'”。
因为 ui_*.h 是由 uic 工具从 .ui 自动生成的，修改 .ui 后必须触发重新生成。
- 保存
.ui文件后，手动执行一次构建（Ctrl+B），不要跳过 - 检查
build-xxx目录下是否有更新的ui_mainwindow.h，里面应包含QLineEdit *lineEditPwd; - 如果仍不生效，删掉
build-xxx目录重建整个构建树（Qt Creator 不会自动清理旧生成物）
真正卡住新手的，从来不是“怎么拖按钮”，而是 Qt 的三件套没对齐：qmake / uic / moc 各自干各的事，中间任一环断开，UI 就静音。
