在CMake中为可执行文件添加GSL仅头文件库遇编译错误求助

问题概况 #

引入Windows平台GNU GSL仅头文件库到C++示例代码时出现编译错误，仓库结构、代码及初始配置如下：

仓库结构 #

folder/
      gsl/
          gsl_sf_bessel.h
          gsl_mode.h
          *.h # 其他头文件
      main.cpp
      CMakeLists.txt

示例代码（main.cpp） #

#include <stdio.h>
#include <gsl_sf_bessel.h>

int main (void)
{
  double x = 5.0;
  double y = gsl_sf_bessel_J0 (x);
  printf ("J0(%g) = %.18e\n", x, y);
  return 0;
}

初始CMake配置（CMakeLists.txt） #

cmake_minimum_required(VERSION 3.0.0)
project(demoproject VERSION 0.1.0)

add_executable(
    demoexecutable
    main.cpp
    )

target_include_directories(
    demoexecutable
    PUBLIC
    gsl/
    )

编译错误 #

fatal error: gsl/gsl_mode.h: No such file or directory
[build]    26 | #include <gsl/gsl_mode.h>

问题原因 #

GSL头文件内部采用#include <gsl/xxx.h>的引用格式，而当前CMake将gsl/目录设为包含路径，导致编译器会在gsl/gsl/路径下查找gsl_mode.h，显然不存在该路径。

解决方案 #

方案一：修改CMake包含路径（推荐） #

将target_include_directories中的路径改为仓库根目录（./），这样编译器能从根目录找到gsl/子目录，完美匹配GSL头文件内部的引用规范。修改后的CMakeLists.txt如下：

cmake_minimum_required(VERSION 3.0.0)
project(demoproject VERSION 0.1.0)

add_executable(
    demoexecutable
    main.cpp
    )

target_include_directories(
    demoexecutable
    PUBLIC
    ./
    )

方案二：调整main.cpp的头文件引用 #

如果不想修改CMake配置，可将main.cpp中的头文件引用改为相对路径格式：

#include <stdio.h>
#include "gsl_sf_bessel.h" // 改用双引号引用当前目录下的头文件

但此方案仅解决当前文件的引用问题，若后续引入更多GSL头文件，仍可能出现类似错误，因此更推荐方案一。

额外提示 #

注意GNU GSL并非纯头文件库，即使编译通过，后续链接阶段还需链接对应的GSL二进制库文件。如果下载的是所谓"仅头文件版本"，需确认是否为真正的纯头文件实现，否则会出现未定义符号的链接错误。

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