如何在CMake构建的C++库中引入OpenXLSX？

你的问题出在src/io/CMakeLists.txt里的两个关键错误：

1. 错误的头文件路径写法 #

target_include_directories(io PUBLIC ../../include ../../external/*) 这行存在两个问题：

• CMake的target_include_directories不支持*通配符写法，这会导致CMake无法正确解析头文件目录。
• 使用相对路径../../external不可靠，CMake的相对路径是基于构建目录而非源文件目录计算的，在复杂项目结构下极易出现路径错误。

2. 冗余且错误的头目录添加 #

实际上你根本不需要手动添加OpenXLSX的头文件目录——通过add_subdirectory(external/OpenXLSX)导入的OpenXLSX::OpenXLSX目标，已经通过CMake的INTERFACE属性自带了所需的头文件路径，只要正确链接这个目标，CMake会自动帮你处理头文件的查找路径。

修复步骤 #

步骤1：清理根目录CMakeLists.txt（可选但更规范） #

移除全局的include_directories(${CMAKE_SOURCE_DIR}/external)，改用目标依赖传递的方式管理头文件路径，避免全局污染：

# 移除这行全局include
# include_directories(${CMAKE_SOURCE_DIR}/external)
add_subdirectory(external/OpenXLSX)

步骤2：修正src/io/CMakeLists.txt中的路径配置 #

修改target_include_directories部分，去掉错误的../../external/*，改用绝对路径变量：

# Optionally glob, but only for CMake 3.12 or later:
set(HEADER_LIST "${MyProject_SOURCE_DIR}/include/io/input.hpp")
# Make an automatic library - will be static or dynamic based on user setting
add_library(io input.cpp ${HEADER_LIST})
# 修正头文件路径，仅保留项目自身的include目录
target_include_directories(io PUBLIC 
    ${PROJECT_SOURCE_DIR}/include
)
# 依赖链接保持不变，OpenXLSX的头路径会自动传递
target_link_libraries(io PUBLIC spdlog::spdlog OpenXLSX::OpenXLSX)
# All users of this library will need at least C++17
target_compile_features(io PUBLIC cxx_std_17)

# IDEs should put the headers in a nice place
source_group(
        TREE "${PROJECT_SOURCE_DIR}/include"
        PREFIX "Header Files"
        FILES ${HEADER_LIST})

修复原理 #

• OpenXLSX::OpenXLSX目标在CMake配置中已经设置了INTERFACE_INCLUDE_DIRECTORIES，包含了自身头文件所在的目录。当你的io库链接这个目标后，CMake会自动把这些路径添加到io库的INTERFACE属性中，所有依赖io库的目标（比如你的wing、mesh模块）都会自动继承这些头文件路径，从而找到<OpenXLSX.hpp>。
• 使用${PROJECT_SOURCE_DIR}这种绝对路径变量，能确保无论构建目录在哪里，CMake都能正确找到项目的头文件目录，避免相对路径带来的混乱。

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