先手动配置Qt版本和编译器：在“工具→选项→构建与运行→Qt Versions”中添加qmake路径，在“Compilers”中确认或添加MinGW/MSVC，最后在“Kits”中新建并绑定二者；路径禁含中文或空格，版本须严格匹配ABI。
Qt Creator启动后找不到Kit怎么办
多数人卡在这一步：安装完Qt Creator，新建项目时提示“Kit is not configured”，或者构建套件列表为空。这不是安装失败，而是Qt版本和编译器没被自动识别。
关键动作是手动关联——Qt Creator不会自动扫描系统里已有的MinGW或MSVC，它只认自己安装包带进来的组件。
- 打开
工具 → 选项 → 构建与运行 → Kits，检查右侧是否有带绿色对勾的Kit；如果没有，先去「Compilers」页确认编译器是否存在（如MinGW 13.1.0 64-bit） - 再去「Qt Versions」页点击「Add」，手动指定
qmake路径：Windows下通常是C:\Qt\6.5.0\mingw_64\bin\qmake.exe，macOS下是/opt/homebrew/opt/qt/bin/qmake - 最后回到「Kits」页，点击「Add」，名称随意，Compiler选刚确认的那个，Qt version选刚添加的那个，Device type保持Desktop即可
常见错误：路径里含中文或空格（比如 C:\Users\张三\Qt），会导致qmake无法加载，Kit始终显示红色感叹号。
为什么新建Qt Widgets项目后UI文件打不开
双击 mainwindow.ui 报错“Cannot open file in Qt Designer”，本质是Qt Creator没绑定Qt Designer可执行文件，或者当前Kit没启用Widgets模块。
先确认你安装时勾选了 Qt Widgets 模块——它不是默认必装项，尤其用在线安装器精简安装时容易漏掉。
- 检查
工具 → 选项 → 构建与运行 → Qt Versions对应版本的Details里，是否列出widgets（不是core或gui单独一项） - 若缺失，重新运行Qt安装程序，在对应Qt版本下勾选
Qt Widgets组件并修复安装 - Qt Designer路径一般不用手动设，但若仍打不开，可在
工具 → 选项 → 环境 → 系统 → Qt Designer中填入C:\Qt\Tools\QtDesigner\designer.exe（Windows）或/opt/homebrew/opt/qt/bin/designer（macOS）
注意：Qt Quick 项目用的是QML编辑器，不走Designer流程，别混淆模板类型。
Qt Creator 18.0.2 Windows x86_64 历史版本安装包，适合需要旧版本 IDE、旧项目兼容、Qt/C++ 项目维护、构建套件配置和调试环境回退的用户使用。
Mac上配置Qt Creator总提示xcode-select: error: command not found
这是Xcode命令行工具根本没装，不是Qt的问题。Qt在macOS依赖clang和make等底层工具，而它们由Xcode CLI提供。
必须先在终端执行 xcode-select --install，弹窗点安装，等进度条走完再重启Qt Creator。否则即使Homebrew装了qt，Kit也会因找不到clang++而失效。
- 验证是否生效：终端运行
clang++ --version，有输出即OK；若报command not found，说明CLI没装或PATH没刷进去 - Homebrew装的Qt路径默认在
/opt/homebrew/opt/qt，但Qt Creator的Qt Versions页里填的是qmake路径，不是目录路径，别填错成/opt/homebrew/opt/qt/bin（缺了/qmake） - 如果用了Apple Silicon芯片，确保安装的是arm64版Qt，而不是x86_64版——后者在M系列Mac上会静默失败
最隐蔽的坑：终端里能跑qmake -v，但Qt Creator里Kit仍报错，大概率是Shell配置没同步到GUI应用，需要把export PATH="/opt/homebrew/opt/qt/bin:$PATH"加到~/.zprofile而非~/.zshrc（macOS 12+对GUI进程读取的初始化文件有区别）。
Windows下用MinGW编译报错“undefined reference to `__imp__...`”
这类链接错误90%是因为混用了不同ABI的库，比如用MinGW-w64 13.1编译，却链接了Qt 6.4.x（built with MinGW-w64 11.2）的动态库。
Qt官方打包的每个MinGW版本都严格绑定特定GCC ABI，跨版本链接必然失败。不要试图“复用旧Qt安装”，也不要从第三方下载独立的MinGW。
- 检查你的Kit中Compiler和Qt Version的版本号是否匹配：比如
MinGW 13.1.0 64-bit必须配Qt 6.5.0 (MinGW 13.1.0 64-bit) - 如果已装多个Qt版本，删除不需要的，避免Qt Creator自动选错——它默认选最新版，但新版Qt未必兼容你手头的旧编译器
- 临时验证方法：在项目.pro文件里加一行
QMAKE_CXXFLAGS += -v，编译时看终端输出的gcc实际调用路径，确认是不是你期望的那个MinGW
真正麻烦的是已经写了一半代码才发现Kit配错——此时不要硬改Kit，直接新建项目，用正确Kit创建，再把源码文件复制过去，比修链接错误快得多。
