必须先配置kit才能写代码运行，否则新建项目会报错；启动后需检查“工具→选项→构建和运行→kits”中是否有绿色对勾的可用kit，若无则依次配置qt版本、编译器并手动绑定，再新建qt widgets application项目并勾选“创建界面”，运行前务必保存文件并清理构建目录。

Qt Creator 安装完成后不能直接写代码运行，必须先确认编译工具链和 Qt 版本已正确识别，否则新建项目会报错或无法构建。

启动后第一件事：检查 Kits 是否就绪

安装完 Qt Creator 启动时，它会尝试自动检测已安装的 Qt 版本和编译器（如 MinGW、MSVC），但这个过程经常失败——尤其是 Windows 下没手动装过编译器，或路径含中文/空格时。

• 打开 工具 → 选项 → 构建和运行 → Kits，看列表里是否有带绿色对勾的 Kit（Status 栏显示 “OK”）
• 如果没有，先去 Qt Versions 标签页确认 Qt 安装路径是否正确（比如 C:\Qt\5.15.2\mingw81_64\bin\qmake.exe）
• 再到 Compilers 标签页确认编译器是否存在（例如 MinGW 8.1 对应 g++.exe 路径）
• 最后在 Kits 页手动新建一个 Kit，绑定刚配好的 Qt 版本和编译器；名称建议用 Desktop Qt 5.15.2 MinGW 8.1 64bit 这类明确标识

创建第一个项目时选错模板会导致 UI 文件不生成

新建项目选 Application → Qt Widgets Application 是最稳妥的入门路径。如果误选 Empty qmake Project 或 Console Application，后续想加 UI 就得手动补 .ui 文件、改 .pro、写 ui_*.h 包含逻辑——初学者极易卡在这一步。

Qt Creator 18.0.2

Qt Creator 18.0.2 Windows x86_64 历史版本安装包，适合需要旧版本 IDE、旧项目兼容、Qt/C++ 项目维护、构建套件配置和调试环境回退的用户使用。

下载

• Qt Widgets Application 自动包含 mainwindow.ui 和 Ui::MainWindow 类封装，双击就能进 Qt Designer 拖控件
• 基类选 QMainWindow（不是 QWidget 或 QDialog），默认带菜单栏和状态栏，更贴近常规桌面应用结构
• 务必勾选 创建界面，否则 .ui 文件不会生成，ui_MainWindow.h 也编译不过

运行前记得保存所有文件并清理构建目录

Qt Creator 不像 VS 那样自动保存全部文件，编辑完 mainwindow.cpp 或 mainwindow.ui 后若没手动 Ctrl+S，点击 ▶️ 运行时可能仍在用旧版本代码——尤其改了 UI 但没保存，界面上就看不到新按钮。

• 构建目录（build-xxx 文件夹）一旦出错，不要硬点“重新构建”，先点 构建 → 清理项目，再 构建 → 重新构建项目
• 如果控制台报错 undefined reference to `vtable for MainWindow'，大概率是 Q_OBJECT 宏所在类没执行 moc（元对象编译），重启 Qt Creator 或删掉构建目录重来通常能解决
• 输出面板（底部）里出现 Starting C:\...\debug\YourApp.exe... 才算真正启动，如果只看到 Running process... 卡住，说明构建失败但没报红字错误，要翻上面几行找 error: 或 failed

真正麻烦的不是安装，而是 Kit 绑定错一个路径、新建项目漏勾“创建界面”、改完 UI 忘保存——这些操作本身一两秒，但排查起来可能耗半小时。动手前花三分钟核对 Kits 和项目模板，比后面反复 clean/rebuild 有效得多。