项目目录结构 #

external
    eigen-5.0.1
        Eigen

source
    <source files>

问题背景 #

当前编译时需同时将external/eigen-5.0.1和source加入-I包含路径。现改为仅头文件库，希望用户仅需添加source到-I路径即可编译，且需满足：

1. 不将Eigen目录移入source，保持外部库与源码分离；
2. 不修改现有#include "Eigen/..."的写法，避免版本变更时逐一修改。

可行解决方案 #

1. 提供编译脚本/批处理文件 #

为用户准备跨平台编译脚本，自动添加外部库的包含路径，用户只需执行脚本即可，无需手动输入多路径：

• Linux/macOS 示例（compile.sh）：

  #!/bin/bash
  # 使用示例：./compile.sh source/your_file.cpp -o your_program
  g++ -I source -I external/eigen-5.0.1 "$@"
  

• Windows 示例（compile.bat）：

  @echo off
  :: 使用示例：compile.bat source\your_file.cpp -o your_program
  g++ -I source -I external\eigen-5.0.1 %*
  

2. 基于构建系统自动配置（推荐） #

如果项目使用CMake等构建工具，在source/CMakeLists.txt中自动添加外部库的包含路径，用户只需在自己的构建脚本中引入source即可：

# source/CMakeLists.txt
cmake_minimum_required(VERSION 3.10)
project(your_project)

# 自动添加Eigen的包含路径，无需用户手动指定
include_directories(${CMAKE_CURRENT_SOURCE_DIR}/../external/eigen-5.0.1)

# 配置仅头文件库
add_library(your_project INTERFACE)
target_include_directories(your_project INTERFACE ${CMAKE_CURRENT_SOURCE_DIR})

用户使用时只需在自己的CMakeLists.txt中添加：

add_subdirectory(path/to/source)

即可自动获取所有必要的包含路径。

3. 转发头文件目录（无构建系统场景） #

在source目录下创建Eigen转发目录，通过统一配置头文件管理外部路径，避免版本变更时逐一修改：

1. 在source下创建project_config.h：

   #define EIGEN_ROOT "../../external/eigen-5.0.1"
   

2. 在source/Eigen下创建对应转发头文件，比如Core：

   #include "../project_config.h"
   #include EIGEN_ROOT "/Eigen/Core"
   

3. 为常用的Eigen头文件创建类似转发文件，后续版本升级仅需修改project_config.h中的路径。

4. 编译器特定配置文件（限Clang/GCC） #

对于Clang或GCC用户，可在source目录下创建.clang_complete文件，指定额外包含路径：

-I../external/eigen-5.0.1

编译器会自动读取该文件配置，用户只需添加-I source即可。

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