Qt项目中CMake添加库源文件后无法找到Qt头文件的问题

1. QTMathLib 未配置 Qt Core 依赖 #

QDebug 属于 Qt Core 模块，你的 QTMathLib 源文件依赖该模块，但直接在 QTUnitTest 的 CMakeLists.txt 中添加源文件生成库时，没有为这个新库目标配置 Qt Core 的依赖。编译器无法找到 Qt 头文件的路径，因此报找不到 QDebug 等头文件的错误。

正确的做法是为 QTMathLib 单独编写 CMakeLists.txt，明确引入 Qt Core：

# QTMathLib/CMakeLists.txt
find_package(Qt6 REQUIRED COMPONENTS Core) # 对应你的 Qt 版本，比如 Qt5
qt_add_library(QTMathLib STATIC
    # 列出 QTMathLib 的所有源文件
    math_utils.cpp
)
target_link_libraries(QTMathLib PRIVATE Qt::Core)

2. 错误复用源文件而非预定义库目标 #

你在 QTUnitTest 中直接添加 QTMathLib 的源文件生成库，相当于重新创建了一个无配置的新库目标，完全没有继承 QTMathLib 所需的编译配置（比如 Qt 头文件路径、Qt 专属编译宏）。

正确流程是：在主 CMakeLists.txt 中引入 QTMathLib 子模块，生成库目标后，再在 QTUnitTest 中链接这个预定义目标：

# 主 CMakeLists.txt
cmake_minimum_required(VERSION 3.16)
project(MyTestProject)
add_subdirectory(QTMathLib)
add_subdirectory(QTUnitTest)

# QTUnitTest/CMakeLists.txt
find_package(Qt6 REQUIRED COMPONENTS Core Test) # 测试通常需要 Qt Test 模块
qt_add_executable(QTUnitTest
    math_test.cpp
)
target_link_libraries(QTUnitTest PRIVATE QTMathLib Qt::Core Qt::Test)

3. 编译配置未自动传递 #

即使 QTUnitTest 本身配置了 Qt，直接将其他模块的源文件添加到当前目标时，这些源文件不会自动继承当前目标的 Qt 编译配置。每个源文件的编译参数与所属目标绑定，单独添加源文件会导致缺少 Qt 头文件路径和必要的编译宏。

内容的提问来源于stack exchange，提问作者gmmo