讲师中心 微信公众号
AI工具推荐 视频效率加速

Qt Creator CMake配置报错怎么解决?

夜磊大大_5491

夜磊大大_5491

发布时间:2026-08-08 16:53:47

|

698人浏览过

|

来源于php中文网

原创

Qt Creator中CMake配置失败主因是Kit未正确绑定编译器或环境变量未继承,需检查Compilers和Kits设置、清空构建目录、确保find_package(Qt6)显式声明COMPONENTS且大小写正确。

qt creator cmake配置报错怎么解决?

Qt Creator 里 CMake 配置失败,90% 是 Kit 没对上编译器或环境变量没继承,不是代码写错了。

Kit 中编译器路径为空或不匹配

Qt Creator 的 Kit(工具链)必须明确指定 C/C++ 编译器路径,否则 CMake 会报 The C++ compiler is not able to compile a simple test program。即使你装了 Visual Studio 或 MinGW,Qt Creator 也不会自动发现它们——它只认你在 Tools → Options → Kits → Compilers 里手动注册的路径。

  • 检查 Compilers 标签页:确认已添加对应版本的 MSVC(如 Microsoft Visual C++ Compiler 14.4 (x64))或 MinGW(如 MinGW 13.1.0 64-bit),路径指向真实的 cl.exeg++.exe
  • 检查 Kits 标签页:选中目标 Kit,确保 C CompilerC++ Compiler 都选中了上面注册好的编译器,且 Debugger 也匹配(比如 MSVC 对应 cdb,MinGW 对应 gdb
  • 常见坑:cl.exe 路径别抄网上的旧路径(如 VC\bin\x86_amd64\cl.exe),VS 2022 默认路径是 MSVC\14.4\bin\Hostx64\x64\cl.exe;MinGW 则优先用 Qt 安装器自带的,而非自行下载的独立版

CMake 构建目录未清空或权限不足

CMake 在构建前会生成缓存文件(CMakeCache.txtCMakeFiles/ 等),如果之前配置失败过,残留状态会导致后续 configure 直接报错,比如 No CMake configuration found 或静默失败。

CMake 4.3.2
CMake 4.3.2

CMake 4.3.2 Windows x86_64 历史版本安装包,适合旧项目兼容、构建环境回退、CMakeLists.txt 迁移验证、Visual Studio/Ninja/Makefile 生成器测试和 C/C++ 项目维护。

下载
  • 在 Qt Creator 中右键项目 → Clean Project 不够彻底,要手动删掉整个构建目录(默认是 build-xxx-Desktop_Qt_6_x_x_MinGW_64bit-Debug 这类名字)
  • Linux 下注意权限:如果曾用 sudo qtcreator 启动过,构建目录可能属 root,普通用户再构建会因写入失败而卡住
  • Windows 上若构建目录在 OneDrive 或 Defender 实时保护太激进,也可能导致 cmake -E env 执行超时或被拦截

CMakeLists.txt 中 find_package(Qt6) 缺少 COMPONENTS

Qt 6 默认关闭模块懒加载,find_package(Qt6 REQUIRED) 只能找到 Qt6::Core,其他模块(如 WidgetsNetwork)必须显式声明,否则链接阶段报 undefined reference,configure 阶段也可能提示 Could NOT find Qt6::Widgets

  • 正确写法:find_package(Qt6 REQUIRED COMPONENTS Core Widgets Network)
  • 注意大小写:Qt 6 要求模块名全大写,widgetsWIDGETS 都不行,只能是 Widgets
  • Qt 版本要和 Kit 匹配:Kit 选的是 msvc2019_64,CMake 就得用对应编译器构建的 Qt 6(比如 Qt 6.5.3 MSVC2019 64-bit),混用 mingw_64 Kit 和 msvc Qt 会找不到库

Linux 下 LD_LIBRARY_PATH 干扰 Qt Creator 自身运行

~/.bashrc 里加了 export LD_LIBRARY_PATH=.../Qt/6.x/gcc_64/lib:$LD_LIBRARY_PATH,会导致 Qt Creator 启动时加载错误版本的 Qt 库,直接崩溃或 CMake 配置失败,报 undefined symbolconfiguration failed

  • 根本解法:删掉 LD_LIBRARY_PATH 相关行,Qt Creator 自带运行时库,不需要外部干预
  • 开发时需要链接 Qt 库?用 target_link_libraries(your_target PRIVATE Qt6::Widgets) 即可,CMake 会自动处理路径
  • 系统级依赖缺失也要补:Ubuntu/Debian 下至少装 libgl1-mesa-dev libxkbcommon-dev libx11-xcb-dev,否则 CMake configure 阶段就终止

真正麻烦的从来不是 CMake 语法,而是 Qt Creator 没拿到正确的环境上下文——它不知道你电脑里装了什么、在哪、能不能用。每次配置失败,先看 Kit 是否完整绑定编译器+Qt 版本+调试器,再清构建目录,最后检查 CMakeLists.txt 里有没有漏 COMPONENTS。这三步走完,八成问题就没了。

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

相关专题

更多
视频后缀名都有哪些
视频后缀名都有哪些

视频后缀名都有avi、mpg、mpeg、rm、rmvb、flv、wmv、mov、mkv、ASF、M1V、M2V、MPE、QT、VOB、RA、RMJ、RMS、RAM、等等。更多关于视频后缀名的相关知识,详情请看本专题下面的文章,php中文网欢迎大家前来学习。

9485

2023.10.31

C++ Qt图形开发
C++ Qt图形开发

本专题专注于 C++ Qt框架在图形界面开发中的应用,系统讲解窗口设计、信号与槽机制、界面布局、事件处理、数据库连接与跨平台打包等核心技能,通过多个桌面应用项目实战,帮助学员快速掌握 Qt 框架并独立完成跨平台GUI软件的开发。

3542

2025.08.15

C++ 图形界面开发基础(Qt方向)
C++ 图形界面开发基础(Qt方向)

本专题系统讲解 使用 C++ 与 Qt 进行图形界面(GUI)开发的核心技能,内容涵盖 Qt 项目结构、窗口组件、信号与槽机制、事件处理、布局管理、资源管理,以及跨平台编译与打包流程。通过多个小型桌面应用实战案例,帮助学习者掌握从界面设计到功能实现的完整 GUI 开发能力。

1341

2025.12.05

C++ 跨平台开发
C++ 跨平台开发

本专题聚焦 C++ 在跨平台应用与工程构建中的实战应用,系统讲解 CMake 构建系统、跨平台编译配置、第三方库集成、调试技巧、静态与动态链接库管理等核心知识。通过实战案例(如跨平台工具开发、Linux与Windows编译兼容性项目),帮助学习者掌握 从环境配置到完整跨平台构建的开发能力。

5286

2025.10.17

c++  cmake用法
c++ cmake用法

本专题整合了c++ cmake用法相关教程,阅读专题下面的文章了解更多详细内容。

1391

2025.10.23

C++ 编译构建系统与CMake实战
C++ 编译构建系统与CMake实战

本专题聚焦 C++ 项目的编译与构建体系,系统讲解 CMake 的核心语法、项目结构设计、库与依赖管理、跨平台构建、调试与发布配置。通过完整项目示例,帮助开发者掌握 从源码到可执行程序的工程化构建流程,提升 C++ 项目在实际开发中的可维护性与扩展性。

314

2025.12.13

NumPy数组创建索引切片与数据选择
NumPy数组创建索引切片与数据选择

本专题整理 NumPy 数组创建、索引、切片与数据选择相关教程,覆盖 np.array、zeros/ones、多维数组形状、基础切片、花式索引、布尔索引、条件筛选、视图与副本等常用场景,帮助读者系统掌握 ndarray 数据构造与高效提取方法。

0

2026.09.21

Aionclaw智能助手介绍
Aionclaw智能助手介绍

本专题汇总了AionClaw(AI龙虾助手)的功能介绍与在线使用入口。AionClaw是杭州趣猿人工智能有限公司推出的桌面级AI智能体,能直接在电脑上读写文件、运行脚本、操作浏览器,自动交付Word、PPT、Excel等成品。

20

2026.09.20

AionClaw AI智能体与电脑自动化任务执行功能使用教程
AionClaw AI智能体与电脑自动化任务执行功能使用教程

AionClaw专题整理AI智能体与电脑自动化相关功能使用教程,涵盖安装部署、AI任务执行、Skills技能、文件处理、浏览器控制、电脑操作、持久记忆、聊天工具连接以及办公、编程和内容创作等功能,帮助用户快速掌握AionClaw的实际使用方法。

0

2026.09.20

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Qt入门课堂 - Qt Quick Controls
Qt入门课堂 - Qt Quick Controls

共0课时 | 0人学习

Qt Creator 调试文档
Qt Creator 调试文档

共0课时 | 0人学习

Qt Creator 项目创建文档
Qt Creator 项目创建文档

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn