Qt Creator项目配置失败报错怎么解决？

大杰同学_5572

发布时间：2026-08-10 17:43:18

802人浏览过

来源于php中文网

原创

Kit 显示“Unconfigured”或“Invalid”通常是Qt Version、Compiler、Debugger三者未正确匹配，或路径含空格/中文导致扫描失败；应检查Tools→Options→Build & Run中各标签页配置并手动指定有效项。

qt creator项目配置失败报错怎么解决？

Kit 显示 “Unconfigured” 或 “Invalid” 怎么办

这是最常见也最容易被当成“没装好 Qt”的假象。实际往往只是 Qt Version、Compiler、Debugger 三者中某一个没对上号，或者路径里有空格/中文导致 Qt Creator 扫描失败。

进 Tools → Options → Build & Run，先看 Qt Versions 标签页：如果列表为空，说明 qmake.exe 没被识别——不是没装 Qt SDK，而是路径没注册或 qmake 根本不存在（比如只装了 Qt Creator，没装 Qt Online Installer）
再看 Compilers 标签页：g++.exe 或 cl.exe 路径是否真实存在？用终端执行 where g++.exe（Windows）或 which g++（Linux/macOS）验证；路径含空格（如 C:\Program Files\...）或中文时，Qt Creator 通常直接跳过扫描
Kits 标签页里，每个 Kit 右侧会显示具体哪一项标红（比如 Debugger: Not found）。别点“Auto-detect”，手动从下拉框选已确认存在的 Debugger（GDB 对应 MinGW，CDB 对应 MSVC）

报错 “CMake project configuration failed” 怎么定位

这个错误不是 CMake 本身坏了，而是 Qt Creator 没法把项目参数正确传给 CMake，根源常在构建目录、缓存或环境变量。

Qt Creator 18.0.2

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

下载

检查构建目录路径是否合法：不能含中文、空格、特殊字符（如 &、@），也不能是系统受限路径（如 Windows 的 C:\Program Files）；推荐设为 D:\build\myproject 这类干净路径
删掉整个构建目录再重试——不是点“Clean”，而是手动删除文件夹。Qt Creator 的缓存（尤其是 CMakeCache.txt 和 CMakeFiles/）经常卡住旧配置
Linux 下重点查 LD_LIBRARY_PATH：如果 ~/.bashrc 里加过 export LD_LIBRARY_PATH=.../Qt/6.5.3/lib:$LD_LIBRARY_PATH，Qt Creator 启动时会优先加载旧版 Qt 库，导致符号冲突崩溃或 CMake 加载失败；直接注释掉这行再重启 Qt Creator

打开别人项目提示 “No valid kits found” 或 “No valid settings file”

本质是本地环境和原项目不匹配，不是你的 Qt Creator 坏了，而是它拒绝加载不兼容的配置。

先删掉项目根目录下的 .pro.user（qmake 项目）或 CMakeLists.txt.user（CMake 项目）——这是纯本地缓存，删了无害，Qt Creator 会重建
检查项目路径：如果路径含中文（如 D:\我的项目\）或空格（如 D:\Qt Projects\），Qt 工具链大概率解析失败；临时挪到 D:\qtproj\ 这类纯英文路径再试
确认 Kit 是否支持该项目使用的 Qt 版本：比如别人用 Qt 6.7 编译，你本地只有 Qt 6.5.3，即使 Kit 显示绿色，也可能在构建时突然报 Unknown module: webenginewidgets——因为 WebEngine 在 6.6+ 才默认启用，且只支持 MSVC

“Unknown module(s) in QT: xxx” 类错误怎么查

这不是语法错，是模块根本没装或编译器不支持。Qt 的模块不是“写就能用”，得看安装包、Qt 版本、编译器三者是否咬合。

运行 qmake -query 查 QT_INSTALL_LIBS 路径，然后进该目录看是否存在 libQt6WebEngineWidgets.so（Linux）或 Qt6WebEngineWidgetsd.dll（Windows）；没有就说明组件没装
WebEngine、Charts、Quick3D 等模块对编译器敏感：MinGW 不支持 WebEngine，必须用 MSVC；Clang 不支持部分 Qt Quick 模块；别硬配，看 Qt 官网对应版本的 Supported Platforms 表格
用 MaintenanceTool 重装组件时，注意勾选的是 Qt WebEngine（不是 Qt WebView），而且要选和当前 Qt 版本、编译器完全一致的子项（比如 Desktop Qt 6.5.3 MSVC2019 64bit）

Kit 配置看着简单，但 Qt Version、Compiler、Debugger、项目路径、系统环境变量五者之间只要有一处错位，就会在不同阶段报不同错——有时是 qmake 找不到，有时是 CMake 报 symbol not found，有时干脆 Qt Creator 自己崩。最省时间的做法是：删缓存、清构建目录、换纯英文路径、用 MaintenanceTool 重装对应组件，而不是逐个猜原因。