Qt Creator 启动提示“no valid kits found”是因未正确关联已安装的Qt版本，需在Tools→Options→Kits→Qt Versions中手动添加qmake路径（如C:\Qt\5.15.2\mingw81_64\bin\qmake.exe），并确保编译器、调试器匹配且路径无空格/中文。

Qt Creator 启动时提示“no valid kits found”或“Qt version is not specified”

这是 Qt Creator 无法关联到已安装 Qt 版本的典型表现，不是 Qt 没装好，而是它压根没“看见”你装的 Qt。常见于手动解压安装 Qt（比如从 qt.io 下载的 qt-opensource-windows-x86-5.15.2.exe 或 Linux/macOS 的离线包），或者 Qt 安装路径里混入了空格、中文、符号，又或者 Qt Creator 是独立安装的（比如通过系统包管理器装的），跟 Qt 二进制不在同一逻辑视图下。

• 检查 Qt Versions 页面：打开 Tools → Options → Kits → Qt Versions，看列表是否为空；若为空，点击 Add… 手动添加 qmake 路径（不是 Qt 安装根目录，是 bin/qmake，例如 C:\Qt\5.15.2\mingw81_64\bin\qmake.exe）
• 确认 qmake 可执行：在终端里运行 qmake --version，如果报“command not found”或权限拒绝，说明该 qmake 不在 PATH 且路径写错，或文件被杀毒软件拦截
• 避免路径含空格/中文：比如 C:\Program Files\Qt\5.15.2\... 很容易出问题，建议重装到 C:\Qt\ 这类干净路径

添加完 qmake 后 Kit 仍显示黄色警告：“Debugger not found”

Kit 是 Qt Creator 里把 Qt 版本、编译器、调试器三者绑在一起的配置单元。即使 qmake 加对了，缺调试器也会导致 Kit 不可用——尤其 Windows 上用 MinGW 时，gdb 默认不随 Qt 安装包附带。

Qt Creator 18.0.2

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

下载

• MinGW 用户：去 mingw81_64\bin\（或对应版本目录）下确认是否存在 gdb.exe；没有就去 MinGW 官网下载完整版（如 mingw-w64-install.exe），勾选 gdb 组件，再把该 bin 目录加进系统 PATH，重启 Qt Creator
• MSVC 用户：确保已安装对应版本的 Visual Studio（如 Qt 5.15.2 + MSVC2019，则需 VS2019 且勾选“C++ build tools”）；Qt Creator 会自动探测 mspdb140.dll 和 cdb.exe，但若 VS 安装路径含空格或权限受限，可能失败
• Linux/macOS：检查 gdb 或 lldb 是否可执行，某些发行版默认不装调试器（Ubuntu 需 sudo apt install gdb）

Qt Creator 显示“Cannot parse CMakeLists.txt”或新建项目时无模板

这通常不是 Qt 版本问题，而是 Kit 关联失败后触发的连锁反应：没有有效 Kit，Creator 就不会加载对应 Qt 的元信息（包括模块支持、项目模板、CMake 配置片段），导致新建项目空白或 CMake 解析失败。

• 先回到 Kits 页面，确认你刚添加的 Qt Version 已被至少一个 Kit 引用（右侧 Qt version 下拉框选中它）
• 检查 Compiler 是否匹配：比如 Qt 是用 mingw81_64 编译的，Kit 里的 Compiler 必须也选同名 MinGW；若选成 Clang 或 MSVC，Kit 会变红并禁用
• 新建项目时，务必在向导第一页选择正确的 Kit（右下角下拉框），而不是依赖默认值——默认 Kit 可能仍是空的

Linux/macOS 下 /usr/local/Qt 等自定义路径始终不识别

Qt Creator 在非 root 权限下运行时，默认只扫描标准路径（如 /opt/Qt、~/Qt），对 /usr/local/Qt 这类系统级路径读取受权限或 PATH 影响较大，尤其 macOS 的 SIP 机制还会阻止访问某些位置。

• 不要用 sudo qtcreator 启动（会破坏配置隔离），改用命令行指定 Qt 路径：qtcreator -settingspath ~/.config/QtProject/qtcreator
• 手动添加 qmake 时，路径必须精确到可执行文件，且该文件有 +x 权限（chmod +x /usr/local/Qt/5.15.2/gcc_64/bin/qmake）
• macOS 上若 Qt 安装在 /Applications/Qt，注意 Finder 解压后可能未保留可执行位，需 xattr -d com.apple.quarantine 清除隔离属性

Qt 版本识别失败，本质是路径、权限、组件完整性三者的组合问题。最常被忽略的是：Kit 里 Qt Version 和 Compiler 的“版本对齐”（比如 5.15.2 + mingw81_64），以及调试器这种“看不见却关键”的依赖。别急着重装 Qt，先翻一遍 Qt Versions 和 Kits 两个页面里的具体报错文字——它几乎总在告诉你缺哪一环。