首次打开 qt creator 应先确认 kit 配置是否就绪，检查右下角状态栏是否有带绿色对勾的 kit（如 desktop qt 5.15.2 mingw 64-bit），否则新建项目运行会报“cannot run: no valid kits found”；kit 缺失常见原因包括安装时未勾选编译器、环境变量未生效、windows 路径含空格/中文或 macos 未装 xcode 命令行工具。

第一次打开 Qt Creator，别急着写代码——先确认 Kit 配置是否就绪，否则新建项目后点运行会直接报错 Cannot run: No valid kits found。

启动后第一件事：检查 Kit 是否自动识别成功

Qt Creator 启动进入欢迎界面后，不建议直接点 “New Project”。先看右下角状态栏（或菜单栏 Tools → Options → Build & Run → Kits）：

• 是否有带绿色对勾的 Kit？例如 Desktop Qt 5.15.2 MinGW 64-bit 或 Desktop Qt 6.5.3 MSVC2019 64-bit
• 如果没有，说明 Qt 安装时没勾选对应编译器/Qt 版本，或环境变量未生效；此时点新建项目也能继续，但后续构建必然失败
• Windows 上常见问题是 MinGW 路径含空格或中文，导致 Kit 检测失败；macOS 上则常因 Xcode 命令行工具未安装而缺 clang

创建第一个能跑起来的 Qt Widgets 项目

确认 Kit 可用后，再走标准流程。关键不是“怎么点”，而是避开三个默认陷阱：

C++

"空空如也"

下载

• 项目路径别用中文或空格，比如 C:/qt_projects/hello 可以，C:/我的项目/测试 会卡在 qmake 步骤
• 类名保持 MainWindow 不改，避免头文件和 UI 文件名不匹配导致 ui_mainwindow.h 生成失败
• Kit Selection 页面，确保勾选了你刚确认有效的那个 Kit；如果灰色不可选，回到上一步修 Kit
• 最后一步，“Generate form” 勾不勾都行，但勾选后会自动生成 mainwindow.ui，方便立刻进设计模式拖控件

双击 .ui 文件进设计模式，但别乱拖控件

项目创建完成并成功构建后，双击 mainwindow.ui 进入 Qt Designer。新手最容易在这里浪费一小时：

• 左侧控件栏里，先只用 QPushButton、QLabel、QLineEdit 这三类，其他高级控件（如 QTableView）依赖模型类，没写逻辑前放上去只是占位符
• 拖完控件必须点右键 → Layout → Lay out Horizontally（或垂直），否则窗口缩放时控件全堆左上角
• 修改控件文本不要双击编辑，而是在右侧 Property Editor 里改 text 属性；双击会触发重命名对象名（objectName），影响后续 findChild 查找
• 信号槽连接：右键按钮 → Go to slot… → clicked()，它会自动在 mainwindow.cpp 里生成空函数体，比手写 connect() 少出错

运行失败时，优先看 Compile Output 和 Application Output 两个面板

点绿色三角形运行后黑窗一闪或报错，别关 IDE，先低头看底部面板：

• Compile Output 里出现 error: ui_mainwindow.h: No such file or directory → 检查是否忘了执行 qmake（右键项目 → Run qmake）
• Application Output 里有 QMetaObject::connectSlotsByName: No matching signal to … → 说明你在 UI 里写了 on_pushButton_clicked() 这种命名，但没实现对应函数，或拼错大小写
• Windows 上弹窗提示 “缺少某某 dll” → 不是代码问题，是运行时没把 Qt5Core.dll 等复制到 exe 同目录，用 windeployqt 工具一键解决（项目右键 → Deploy）

真正卡住的地方往往不是语法，而是 Kit 配置、路径字符、UI 布局缺失这三类低级但隐蔽的问题；等一个空白窗口弹出来，才算真正跨过第一道门槛。