CMake编译：Qt库无法被子目录静态库访问的问题排查

原因 #

1. SQLite3头文件可访问的原因：

   • 要么sqlite3.h位于系统默认的头文件搜索路径（如/usr/include），无需额外配置就能被所有编译单元找到；
   • 要么find_package(SQLite3 REQUIRED)自动将SQLite的头文件路径添加到了全局包含目录，使得子目录的静态库能间接访问。

2. Qt头文件无法访问的原因：

   • Qt的find_package不会把头文件路径添加到全局包含目录，而是通过**目标（Qt${QT_VERSION_MAJOR}::Widgets）**管理依赖。你仅在根目录将Qt链接到最终可执行文件OrderBookDemo，但静态库OrderBook本身既没有链接Qt目标，也没有获取到Qt的头文件搜索路径，因此编译OrderBook时找不到QApplication的头文件。

解决方案 #

两种修复方式任选其一即可：

方式一：在子目录CMakeLists中直接依赖Qt #

修改OrderBook/CMakeLists.txt，添加Qt的包查找与链接逻辑：

project(OrderBook)
# 移除多余的add_definitions(-std=c++14)，根目录已统一设置C++17标准
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

set(HEADER_FILES OrderBook.hpp)
set(SOURCE_FILES OrderBook.cpp)

add_library(OrderBook STATIC ${SOURCE_FILES} ${HEADER_FILES})

# 添加Qt依赖配置
find_package(QT NAMES Qt6 Qt5 REQUIRED COMPONENTS Widgets)
find_package(Qt${QT_VERSION_MAJOR} REQUIRED COMPONENTS Widgets)

target_link_libraries(OrderBook PRIVATE Qt${QT_VERSION_MAJOR}::Widgets)

• 使用PRIVATE是因为OrderBook仅自身需要Qt，无需将Qt依赖暴露给依赖它的其他目标（如OrderBookDemo）。

方式二：在根目录传递Qt依赖给子库 #

修改根目录CMakeLists.txt，在链接OrderBook时传递Qt依赖：

# 原target_link_libraries修改为：
target_link_libraries(OrderBookDemo
  PRIVATE
    OrderBook
    DBHandler
    Qt${QT_VERSION_MAJOR}::Widgets
    SQLite::SQLite3
)

# 给OrderBook添加Qt依赖传递
target_link_libraries(OrderBook PRIVATE Qt${QT_VERSION_MAJOR}::Widgets)

• 这种方式无需修改子目录的CMakeLists，直接在根目录统一管理子库依赖，适合集中配置的场景。

额外优化建议 #

• 移除OrderBook/CMakeLists.txt中的add_definitions(-std=c++14)，根目录已设置C++17标准，重复设置可能引发版本冲突；
• 尽量避免使用include_directories这种全局包含方式，改用target_include_directories为具体目标设置包含路径，更符合现代CMake的依赖管理规范。

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