在CMake项目中使用xlsxwriter库遇头文件未找到问题求助

出现fatal error: 'xlsxwriter.h' file not found错误，说明编译时未正确配置头文件搜索路径——即便CMake能找到库文件，也不会自动关联对应的头文件目录。以下是具体排查和解决步骤：

1. 确认头文件实际存在 #

先通过命令验证头文件路径的有效性：

ls -l /usr/local/include/xlsxwriter.h

如果输出显示文件不存在，重新执行brew reinstall xlsxwriter修复安装，或检查brew安装过程是否有报错。

2. 在CMakeLists.txt中显式添加头文件搜索路径 #

CMake默认的include路径可能未包含/usr/local/include（Apple Silicon设备为/opt/homebrew/include），需手动指定。以下是修正后的最简配置：

cmake_minimum_required(VERSION 3.10)
project(xlsxwriter_demo)

# 添加头文件搜索目录
include_directories(/usr/local/include)

# 查找xlsxwriter库文件
find_library(XLSXWRITER_LIB xlsxwriter PATHS /usr/local/lib)

# 生成可执行文件
add_executable(demo main.cpp)

# 链接xlsxwriter库
target_link_libraries(demo ${XLSXWRITER_LIB})

3. 适配Apple Silicon设备的brew路径差异 #

若你的Mac是Apple Silicon架构，brew默认安装路径为/opt/homebrew而非/usr/local。可通过brew --prefix获取准确路径，修改CMakeLists.txt实现跨架构适配：

cmake_minimum_required(VERSION 3.10)
project(xlsxwriter_demo)

# 获取brew安装前缀
execute_process(COMMAND brew --prefix OUTPUT_VARIABLE BREW_PREFIX OUTPUT_STRIP_TRAILING_WHITESPACE)

# 配置头文件和库的搜索路径
include_directories(${BREW_PREFIX}/include)
link_directories(${BREW_PREFIX}/lib)

# 查找库并链接
find_library(XLSXWRITER_LIB xlsxwriter)
add_executable(demo main.cpp)
target_link_libraries(demo ${XLSXWRITER_LIB})

4. 排查环境本身是否正常 #

若上述修改后仍报错，直接用g++编译测试，确认环境无问题：

g++ main.cpp -o demo -I/usr/local/include -L/usr/local/lib -lxlsxwriter

如果该命令能成功编译，说明是CMake配置被其他指令覆盖；若编译失败，重新安装xlsxwriter即可。

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