1. 项目概述一个让Qt新手深夜抓狂的CMake报错到底在说什么“No SOURCES given to target: project”——这行报错我第一次看到时正调试一个刚从Qt Creator默认模板生成的工程编译按钮一点终端瞬间刷出红色文字像一盆冰水浇在刚写完三行main.cpp的兴奋头上。它不报语法错误不报链接失败甚至不提.h或.cpp文件名就冷冷地宣告“你定义了一个叫project的目标但没给它任何源代码。”听起来荒谬可现实中90%以上遇到这个报错的开发者其实已经把.cpp文件放在了工程目录里甚至用ls确认过它们确实存在。问题根本不在文件有没有而在于CMake压根没“看见”它们——不是文件系统层面的看不见是CMakeLists.txt的逻辑层面彻底忽略了它们。这个报错高频出现在QtCMake组合场景中尤其当开发者从Qt Creator的图形化向导跳转到手动编辑CMakeLists.txt时断层感极强。Qt Creator自动生成的脚本里藏着大量隐式约定比如add_executable(project main.cpp)这行看似简单的命令背后绑定着Qt的find_package(Qt6 REQUIRED COMPONENTS Core Widgets)、target_link_libraries(project PRIVATE Qt6::Core Qt6::Widgets)以及最关键的——源文件列表必须显式、完整、且路径正确地传递给add_executable或add_library。一旦你删掉main.cpp、改名成main.cc、或者把源文件挪进src/子目录却忘了更新CMakeLists.txt里的路径CMake就会立刻翻脸抛出这句精准又冷漠的提示。它不是一个编译器错误而是CMake配置阶段的逻辑校验失败。CMake在解析你的CMakeLists.txt时会逐行构建一个“目标-源文件”映射表。当它读到add_executable(project)这一行会立即检查括号内是否跟有至少一个源文件路径。如果没有它不会尝试去目录下自动扫描.cpp也不会报“找不到main.cpp”而是直接终止配置告诉你“目标已声明但源为空”。这种设计哲学很CMake——极度强调显式性与确定性拒绝任何魔法推断。对习惯了IDE自动补全和隐式依赖管理的Qt新手来说这就像开车时突然被拔掉方向盘所有直觉都失效了。所以这行报错的本质是CMake在说“你告诉我要构建一个叫project的可执行程序但我手里一张源代码的纸条都没有。请立刻、明确、无歧义地告诉我哪些文件是它的原料。” 它不关心你用的是Qt6还是Qt5不关心你是否写了QApplication a(argc, argv)只死磕一个事实add_executable的参数列表里有没有.cpp、.cc、.cxx这类扩展名的文件路径。解决它不需要高深的Qt机制只需要一次对CMake构建逻辑的重新校准。接下来我会带你一层层剥开这个报错背后的完整技术链条从最基础的语法陷阱到Qt特有的模块链接陷阱再到跨平台路径处理的暗坑全部用实测案例说话。2. 核心细节解析与实操要点为什么“写了文件名”还是报错这个问题的迷惑性在于很多开发者明明在add_executable里写了文件名却依然报错。根源在于CMake对“源文件”的认定极其苛刻它要求路径必须满足三个硬性条件存在性、可访问性、显式声明性。缺一不可。下面拆解几个最典型、最高频的“写了却无效”的场景每个都附带实测验证和避坑口诀。2.1 场景一文件扩展名不被CMake识别为源码CMake内置了一套源文件类型白名单.cpp、.cc、.cxx、.c、.mObjective-C、.mmObjective-C等是标准成员。但如果你用了.C大写C、.cp、.cppp或者更常见的——Qt Designer生成的.ui文件CMake会直接忽略它们哪怕你把它写进了add_executable参数里。实测记录我在一个空目录下创建main.C注意大写C内容为标准Qtmain()函数。CMakeLists.txt写为cmake_minimum_required(VERSION 3.16) project(myapp LANGUAGES CXX) find_package(Qt6 REQUIRED COMPONENTS Core Widgets) add_executable(myapp main.C) # 看似合理 target_link_libraries(myapp PRIVATE Qt6::Core Qt6::Widgets)执行cmake -B build后报错正是No SOURCES given to target: myapp。原因分析CMake在解析add_executable(myapp main.C)时先检查main.C是否存在存在再检查其扩展名是否在CMake源码类型列表中C大写不在默认列表里因此该文件被过滤掉myapp目标实际接收的源文件列表为空。提示CMake源码类型列表可通过get_property命令查看但实践中无需记忆。牢记一个口诀小写扩展名是铁律.cpp.cc.cxx.c是安全区其他一律视为非源码。.ui文件必须通过qt6_add_resources或qt6_wrap_ui等专用命令处理绝不能直接塞进add_executable。2.2 场景二路径错误——相对路径的“当前工作目录”陷阱CMakeLists.txt中的路径永远是相对于该CMakeLists.txt所在目录的。这是新手最容易栽跟头的地方。假设你的项目结构是myproject/ ├── CMakeLists.txt ├── src/ │ └── main.cpp └── ui/ └── mainwindow.ui如果CMakeLists.txt里写add_executable(myapp src/main.cpp)一切正常。但如果你手快写成add_executable(myapp ./src/main.cpp)或add_executable(myapp ../src/main.cpp)前者可能侥幸成功取决于CMake版本后者则必然失败——因为..会试图跳出myproject/目录而CMakeLists.txt就在myproject/下..指向的是父目录src/main.cpp自然不存在。更隐蔽的陷阱是CMAKE_SOURCE_DIR误用有人想“保险起见”写成add_executable(myapp ${CMAKE_SOURCE_DIR}/src/main.cpp)。这看起来天衣无缝但CMAKE_SOURCE_DIR是CMake内部变量在project()命令执行前是未定义的如果你把add_executable写在project()之前${CMAKE_SOURCE_DIR}会被展开为空字符串结果变成add_executable(myapp /src/main.cpp)绝对路径/src/main.cpp显然不存在。注意project()命令是CMakeLists.txt的基石它初始化所有核心变量包括CMAKE_SOURCE_DIR、CMAKE_BINARY_DIR。所有add_executable、add_library、find_package等命令必须放在project()之后。这是硬性顺序违反即报错或行为异常。2.3 场景三Qt特定陷阱——qt6_add_executablevsadd_executableQt6官方推荐使用qt6_add_executable替代原生add_executable因为它会自动处理.ui、.qrc、.qml等Qt特有文件的预处理。但很多人不知道qt6_add_executable的参数规则和add_executable完全一致它同样要求第一个参数后必须紧跟源文件列表。致命误区# 错误示范以下代码会报No SOURCES qt6_add_executable(myapp) # 没有源文件 target_sources(myapp PRIVATE src/main.cpp) # 这行太晚了目标已创建且为空这里的问题在于qt6_add_executable(myapp)这行单独执行时myapp目标已被创建且源文件列表为空。后续的target_sources只是向已存在的目标追加源但CMake的校验发生在qt6_add_executable执行瞬间此时校验失败流程终止target_sources根本没机会运行。正确写法必须是# 正确源文件必须和目标名在同一行声明 qt6_add_executable(myapp src/main.cpp src/mainwindow.cpp src/mainwindow.h ) # 或者用原生add_executable 手动处理Qt文件 add_executable(myapp src/main.cpp src/mainwindow.cpp) qt6_wrap_ui(myapp_HDRS src/mainwindow.ui) # 预处理.ui生成头文件 target_sources(myapp PRIVATE ${myapp_HDRS})2.4 场景四GLOB陷阱——自动收集文件的“伪智能”很多教程推荐用file(GLOB ...)自动收集源文件例如file(GLOB SOURCES src/*.cpp) add_executable(myapp ${SOURCES})这看起来很美但CMake官方文档明确警告GLOB是危险的不应在生产环境使用。原因有二增量构建失效CMake的依赖跟踪基于add_executable命令中显式列出的文件。GLOB生成的列表在cmake配置阶段只计算一次后续新增.cpp文件CMake不会自动重新运行GLOB导致新文件不参与编译除非手动rm -rf build/ cmake -B build。路径解析歧义GLOB的通配符匹配依赖于shell不同系统Windows cmd vs Linux bash行为可能不一致src/*.cpp在Windows下可能匹配不到文件。实操心得我曾在一个跨平台团队踩过此坑。Linux开发机上GLOB一切正常Windows CI服务器却始终报No SOURCES排查三天才发现是Windows的cmd对引号和通配符处理不同。永远用显式列表add_executable(myapp src/main.cpp src/widget.cpp src/dialog.cpp)。虽然多敲几行但构建可重现、可追溯、零歧义。现代编辑器VS Code, Qt Creator都有文件拖拽生成列表的功能效率并不低。3. 实操过程与核心环节实现从零构建一个抗报错的Qt CMake工程现在我们抛弃所有“可能出错”的捷径用最扎实、最符合CMake哲学的方式从头搭建一个能稳定通过No SOURCES校验的Qt工程。整个过程严格遵循CMake最佳实践并针对Qt特性做加固。我会展示每一步的命令、预期输出、以及关键决策背后的原理。3.1 第一步初始化项目结构与最小CMakeLists.txt创建干净目录避免任何遗留文件干扰mkdir qt-cmake-demo cd qt-cmake-demo mkdir src build在项目根目录qt-cmake-demo/创建CMakeLists.txt内容如下# CMakeLists.txt - 最小可行版本 cmake_minimum_required(VERSION 3.16) # Qt6要求最低3.16 project(qt_cmake_demo VERSION 1.0 LANGUAGES CXX) # 必须在第一行后立即调用 # 查找Qt6指定必需组件 find_package(Qt6 REQUIRED COMPONENTS Core Widgets Gui) # 创建可执行目标显式列出所有源文件 # 注意路径是相对于本CMakeLists.txt所在目录即根目录 add_executable(qt_cmake_demo src/main.cpp ) # 链接Qt库 target_link_libraries(qt_cmake_demo PRIVATE Qt6::Core Qt6::Widgets Qt6::Gui ) # 设置C标准Qt6推荐C17 set_property(TARGET qt_cmake_demo PROPERTY CXX_STANDARD 17) set_property(TARGET qt_cmake_demo PROPERTY CXX_STANDARD_REQUIRED ON)关键点解析project()必须紧随cmake_minimum_required()之后这是CMake的语法强制要求。LANGUAGES CXX明确告知CMake本项目使用C触发C相关规则如默认编译器标志。find_package(Qt6 ...)必须在add_executable之前否则Qt6::Core等别名无法解析。REQUIRED确保Qt未找到时立即报错而非静默失败。add_executable的参数列表中src/main.cpp是唯一且必需的源文件。路径src/main.cpp是相对路径CMake会自动拼接为$CMAKE_SOURCE_DIR/src/main.cpp。target_link_libraries使用PRIVATE关键字表示这些库仅用于qt_cmake_demo的链接不传递给依赖它的其他目标这是现代CMake的推荐做法避免依赖污染。3.2 第二步编写src/main.cpp并验证基础编译在src/目录下创建main.cpp#include QApplication #include QLabel int main(int argc, char *argv[]) { QApplication app(argc, argv); QLabel label(Hello from CMake Qt6!); label.resize(300, 100); label.show(); return app.exec(); }验证命令与预期输出# 进入build目录执行配置 cd build cmake -DCMAKE_BUILD_TYPEDebug -DCMAKE_PREFIX_PATH/path/to/Qt6 .. # 注意Qt6路径需替换为你的实际安装路径提示CMAKE_PREFIX_PATH是告诉CMake去哪里找Qt6的Config.cmake文件。Linux/macOS通常是/opt/Qt6/6.5.0/gcc_64/lib/cmake/Qt6Windows是C:/Qt/6.5.0/msvc2019_64/lib/cmake/Qt6。如果Qt6在系统PATH中且注册了可省略此参数。如果一切正确你应该看到类似输出-- The CXX compiler identification is GNU 11.4.0 -- Detecting CXX compiler ABI info -- Detecting CXX compiler ABI info - done -- Checking whether CXX compiler has -isysroot -- Checking whether CXX compiler has -isysroot - no -- Checking whether CXX compiler supports OSX deployment target -- ... -- Found Qt6: /opt/Qt6/6.5.0/gcc_64/lib/cmake/Qt6 (found suitable version 6.5.0, minimum required is 6.0.0) -- Configuring done -- Generating done -- Build files have been written to: /path/to/qt-cmake-demo/build没有No SOURCES报错且Found Qt6行出现即配置成功。此时build/目录下已生成MakefileLinux/macOS或qt_cmake_demo.slnWindows。3.3 第三步添加Qt Designer UI文件——qt6_wrap_ui实战现在我们引入.ui文件这是Qt项目标配也是No SOURCES报错的高发区。创建src/mainwindow.ui可用Qt Designer生成或手动写一个最小XML!-- src/mainwindow.ui -- ?xml version1.0 encodingUTF-8? ui version4.0 classMainWindow/class widget classQMainWindow nameMainWindow property namegeometry rect x0/x y0/y width400/width height300/height /rect /property widget classQWidget namecentralwidget/ /widget resources/ connections/ /ui修改CMakeLists.txt加入UI处理逻辑# 在add_executable之后target_link_libraries之前添加以下内容 # 1. 使用qt6_wrap_ui预处理.ui文件生成对应的头文件如ui_mainwindow.h qt6_wrap_ui(UI_HEADERS src/mainwindow.ui ) # 2. 将生成的头文件添加到目标的源文件列表中 # 注意必须用target_sources不能直接写在add_executable里 target_sources(qt_cmake_demo PRIVATE ${UI_HEADERS} # 这里是变量包含生成的头文件路径 ) # 3. 同时需要添加mainwindow.cpp和.h假设已创建 # 假设src/下已有 mainwindow.h 和 mainwindow.cpp target_sources(qt_cmake_demo PRIVATE src/mainwindow.h src/mainwindow.cpp )原理说明qt6_wrap_ui是一个CMake函数它会调用uic工具将mainwindow.ui转换为ui_mainwindow.h并将其路径存入UI_HEADERS变量。target_sources命令则将这些生成的头文件“注入”到qt_cmake_demo目标中使其参与编译。这比把ui_mainwindow.h硬编码进add_executable更健壮因为uic的输出路径由CMake管理且target_sources支持增量更新。3.4 第四步处理资源文件.qrc——qt6_add_resources加固Qt资源文件.qrc用于打包图片、图标等。创建src/resources.qrc!-- src/resources.qrc -- RCC qresource prefix/images fileicon.png/file /qresource /RCC注icon.png可暂不创建CMake会检查其存在性但qrc文件本身必须存在在CMakeLists.txt中添加# 在qt6_wrap_ui之后添加 qt6_add_resources(RESOURCE_FILES src/resources.qrc ) target_sources(qt_cmake_demo PRIVATE ${RESOURCE_FILES} )关键点qt6_add_resources会调用rcc工具将.qrc编译为C源文件如qrc_resources.cpp并返回其路径给RESOURCE_FILES变量。target_sources再次负责将其加入目标。至此一个包含main.cpp、mainwindow.ui、mainwindow.h/.cpp、resources.qrc的完整Qt工程其CMakeLists.txt已完全规避No SOURCES风险。3.5 第五步终极加固——启用CMake Policy和严格模式为了杜绝未来因CMake版本升级带来的隐式行为变化我们在CMakeLists.txt开头添加策略声明cmake_minimum_required(VERSION 3.16) # 启用严格模式禁止隐式链接强制显式声明 if(POLICY CMP0079) cmake_policy(SET CMP0079 NEW) # 要求所有target_link_libraries必须指定INTERFACE/PUBLIC/PRIVATE endif() if(POLICY CMP0091) cmake_policy(SET CMP0091 NEW) # 禁止在add_executable中使用未声明的变量 endif() project(qt_cmake_demo VERSION 1.0 LANGUAGES CXX) # ... 其余内容不变效果CMP0079确保target_link_libraries必须带作用域关键字避免全局链接污染CMP0091让CMake在add_executable中检测到未定义变量如${MISSING_VAR}时直接报错而不是静默忽略。这相当于给CMake装上了“语法检查器”让潜在的No SOURCES隐患在配置阶段就暴露出来。4. 常见问题与排查技巧实录那些年我们一起踩过的坑在多个Qt项目和团队协作中我整理了一份No SOURCES报错的“黑话词典”和速查手册。这些问题往往症状相似但根因千差万别。下面按排查优先级排序每个都附带真实日志片段、定位方法和一招制敌的解决方案。4.1 问题速查表根据报错上下文快速定位报错完整信息最可能原因诊断命令修复方案CMake Error at CMakeLists.txt:10 (add_executable): No SOURCES given to target: myappadd_executable(myapp)后无参数或参数为空变量cmake -DVERBOSEON -B build查看变量展开检查第10行确认add_executable后是否有文件或${VAR}是否已正确定义CMake Error: No SOURCES given to target: myapp无行号project()命令缺失或位置错误head -n 5 CMakeLists.txt检查前5行确保cmake_minimum_required后紧跟project()且project()在add_executable之前CMake Error at CMakeLists.txt:15 (qt6_add_executable): No SOURCES given to target: myappqt6_add_executable(myapp)单独一行未带源文件grep -n qt6_add_executable CMakeLists.txt将源文件列表与qt6_add_executable写在同一行或改用add_executabletarget_sourcesCMake Error: No SOURCES given to target: myapp-- Configuring incomplete, errors occurred!find_package(Qt6 ...)失败导致后续Qt6::Core等别名未定义CMake跳过add_executable解析cmake -DCMAKE_VERBOSE_MAKEFILEON -B build 21 | grep -i qt6|not found检查CMAKE_PREFIX_PATH运行find /path/to/Qt6 -name Qt6Config.cmake确认路径4.2 经典案例深度复盘CI服务器上的“幽灵”报错场景一个在本地Ubuntu上完美编译的Qt工程推送到GitLab CI后cmake -B build步骤总是报No SOURCES。CI日志显示Qt6已找到CMakeLists.txt和本地完全一致。排查过程首先怀疑路径问题CI的CMAKE_SOURCE_DIR是/builds/user/project而src/main.cpp路径正确。检查文件权限ls -l src/显示main.cpp权限为-rw-r--r--无问题。关键线索CI日志中有一行被忽略的警告CMake Warning at CMakeLists.txt:5 (project): VERSION not specified.。原来CI使用的CMake版本3.10低于project(... VERSION ...)语法要求3.12导致project()命令执行失败CMAKE_SOURCE_DIR等变量未初始化后续所有相对路径解析都失效src/main.cpp被当作不存在。解决方案升级CI的CMake版本推荐或降级CMakeLists.txt语法移除VERSION和LANGUAGES参数cmake_minimum_required(VERSION 3.10) # 适配旧CMake project(qt_cmake_demo) # 移除VERSION和LANGUAGES # 其余不变4.3 文件存在性验证三步法确认CMake“真看见”当怀疑文件路径问题时不要凭感觉用CMake原生命令验证步骤1确认文件物理存在# 在项目根目录执行 ls -la src/main.cpp # 应输出类似-rw-r--r-- 1 user user 234 May 1 10:00 src/main.cpp步骤2在CMakeLists.txt中插入调试信息在add_executable之前添加message(STATUS CMAKE_SOURCE_DIR ${CMAKE_SOURCE_DIR}) message(STATUS Full path to main.cpp ${CMAKE_SOURCE_DIR}/src/main.cpp) message(STATUS File exists? $BOOL:${CMAKE_SOURCE_DIR}/src/main.cpp)运行cmake -B build观察STATUS输出。如果File exists?显示FALSE说明路径拼接错误或文件不存在。步骤3强制CMake报错以暴露路径临时将add_executable改为add_executable(qt_cmake_demo NONEXISTENT_FILE.cpp) # 故意写错运行cmake -B buildCMake会报错CMake Error: File NONEXISTENT_FILE.cpp does not exist.并显示它正在查找的完整绝对路径。将这个路径与你的ls结果对比就能100%确认路径问题所在。4.4 Qt版本混用陷阱Qt6的qt6_add_executable在Qt5项目中失效现象项目实际使用Qt5但CMakeLists.txt中错误地写了qt6_add_executable报错No SOURCES同时伴随Unknown CMake command qt6_add_executable。根因qt6_add_executable是Qt6专属命令Qt5中不存在。CMake在解析到未知命令时会跳过整行导致add_executable逻辑未执行目标未创建后续所有操作都无效。解决方案Qt5项目必须用find_package(Qt5 REQUIRED COMPONENTS Core Widgets)add_executabletarget_link_libraries(Qt5::Core Qt5::Widgets)。Qt6项目坚持用find_package(Qt6 ...)qt6_add_executable或add_executable。通用方案推荐用CMake的find_package版本检查find_package(Qt6 6.0 REQUIRED COMPONENTS Core Widgets) if (Qt6_FOUND) qt6_add_executable(myapp src/main.cpp) else() find_package(Qt5 5.15 REQUIRED COMPONENTS Core Widgets) add_executable(myapp src/main.cpp) target_link_libraries(myapp PRIVATE Qt5::Core Qt5::Widgets) endif()4.5 终极避坑清单写CMakeLists.txt的七条军规基于十年Qt/CMake实战我总结出这份不容妥协的清单每一条都对应一个血泪教训军规一project()是圣殿之门所有构建命令必须在其后。把它想象成一道门cmake_minimum_required是钥匙project()是门本身add_executable等是进门的人。没人能绕过门直接进去。军规二源文件路径永远用src/main.cpp这样的相对路径禁用./src/main.cpp或../src/main.cpp。.和..是给shell用的CMake只认相对于CMAKE_SOURCE_DIR的路径。军规三Qt文件.ui,.qrc绝不直接塞进add_executable。.ui用qt6_wrap_ui.qrc用qt6_add_resources然后用target_sources注入。这是Qt官方钦定的唯一安全路径。军规四禁用file(GLOB ...)收集源文件。宁可多写十行target_sources也不要GLOB。显式即正义可重现即可靠。军规五target_link_libraries必须带作用域PRIVATE/PUBLIC/INTERFACE。PRIVATE是最安全的默认值表示“只给我自己用”。军规六CMake版本声明要保守。cmake_minimum_required(VERSION 3.16)足够Qt6但若团队有旧机器可降至3.10并移除VERSION等新语法。军规七每次修改CMakeLists.txt先rm -rf build/再cmake -B build。CMake的缓存机制强大但有时会记住错误的路径状态。彻底重建是最快的“重启大法”。最后分享一个小技巧在VS Code中安装“CMake Tools”插件它会在编辑CMakeLists.txt时实时高亮语法错误并在保存时自动触发cmake configure任何No SOURCES类错误都会在编辑器底部状态栏红色闪烁比切换终端看日志快十倍。这已经成为我每天开工的第一件事——让错误在敲下回车的瞬间就暴露而不是在编译完成后的绝望时刻。