如何在CMake中适配uuid.h的不同系统路径且避免冗余包含？

针对你遇到的uuid.h在不同发行版路径不一致的问题，这里提供两种基于CMake的解决方案，既不用额外添加包含路径，也能最小化源码冗余：

方案1：CMake探测+中间兼容头文件 #

这是最直接的方式，通过CMake自动检测系统中uuid.h的位置，再用一个中间头文件封装条件包含逻辑，让业务源码不用关心路径差异：

步骤1：在CMakeLists.txt中添加探测逻辑 #

首先引入CheckIncludeFile模块来检测头文件存在性，然后向源码传递预处理器宏：

include(CheckIncludeFile)

# 检测两种路径下的uuid.h
check_include_file("uuid/uuid.h" HAVE_UUID_UUID_H)
check_include_file("linux/uuid.h" HAVE_LINUX_UUID_H)

# 确保至少找到一种路径，否则终止构建
if(NOT HAVE_UUID_UUID_H AND NOT HAVE_LINUX_UUID_H)
    message(FATAL_ERROR "uuid.h not found in /usr/include/uuid/ or /usr/include/linux/")
endif()

# 给库目标传递对应的预处理器宏
target_compile_definitions(你的库目标名
    PRIVATE
        $<$<BOOL:${HAVE_UUID_UUID_H}>:USE_UUID_SUBDIR>
        $<$<BOOL:${HAVE_LINUX_UUID_H}>:USE_LINUX_SUBDIR>
)

步骤2：创建兼容头文件 #

在源码目录下新建uuid_compat.h，内容如下：

#ifndef UUID_COMPAT_H
#define UUID_COMPAT_H

#ifdef USE_UUID_SUBDIR
#include <uuid/uuid.h>
#elif defined(USE_LINUX_SUBDIR)
#include <linux/uuid.h>
#else
#error "No valid uuid.h path detected during build"
#endif

#endif /* UUID_COMPAT_H */

之后，所有需要使用uuid相关函数的源码，只需包含这个兼容头文件：#include "uuid_compat.h"，不用再写具体路径。

方案2：CMake INTERFACE目标封装依赖 #

如果不想在源码中引入额外兼容头文件，可用CMake的INTERFACE目标封装依赖逻辑，本质还是基于探测后的条件处理：

include(CheckIncludeFile)

add_library(uuid_deps INTERFACE)

check_include_file("uuid/uuid.h" HAVE_UUID_UUID_H)
check_include_file("linux/uuid.h" HAVE_LINUX_UUID_H)

if(NOT HAVE_UUID_UUID_H AND NOT HAVE_LINUX_UUID_H)
    message(FATAL_ERROR "uuid.h not found in expected paths")
endif()

# 根据探测结果给INTERFACE目标添加定义
target_compile_definitions(uuid_deps INTERFACE
    $<$<BOOL:${HAVE_UUID_UUID_H}>:UUID_IN_UUID_SUBDIR>
)

# 将INTERFACE目标链接到你的库
target_link_libraries(你的库目标名 PRIVATE uuid_deps)

这种情况下，源码中需要做简单的条件包含：

#ifdef UUID_IN_UUID_SUBDIR
#include <uuid/uuid.h>
#else
#include <linux/uuid.h>
#endif

为什么之前的预处理器变量替换不可行？ #

预处理器对#include <UUID_SUBDIR/uuid.h>这类写法不会展开宏替换——<>中的路径会被直接当作字符串处理，无法解析宏变量，因此必须通过条件分支的方式选择不同的include语句。

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