Qt Creator找不到Qt版本报错怎么办？-C++-PHP中文网

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找不到qt版本报错怎么办？

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 两个页面里的具体报错文字——它几乎总在告诉你缺哪一环。