C++ 17 __has_include预处理表达式

枫2024-10-172024-10-19

C++ 17 __has_include预处理表达式

__has_include 是 C++17 标准化的一个预处理特性，用来判断某个头文件是否存在。它特别适合做兼容性处理，比如“有这个头文件就包含，没有就走备用方案”。

1. 为什么需要它？

以前做跨平台或者兼容不同编译环境时，经常会遇到这样的问题：

某些标准库头文件在旧环境里没有
某些第三方库只在部分机器安装了
同一功能在不同平台的头文件名字不一样

如果没有 __has_include，这类判断通常只能依赖构建系统或者手工配置。
有了它之后，预处理阶段就能直接判断头文件是否存在。

2. 基本语法

1
2
3

#if __has_include(<optional>)
#include <optional>
#endif

或者：

1
2
3

#if __has_include("my_config.h")
#include "my_config.h"
#endif

它既支持尖括号形式，也支持双引号形式。

3. 最简单的示例

#include <iostream>

#if __has_include(<optional>)
#include <optional>
#define HAS_OPTIONAL 1
#else
#define HAS_OPTIONAL 0
#endif

int main()
{
    std::cout << HAS_OPTIONAL << std::endl;
    return 0;
}

如果当前编译环境支持 <optional>，就会输出 1。

4. 常见使用场景

4.1 标准库兼容处理

#if __has_include(<filesystem>)
#include <filesystem>
namespace fs = std::filesystem;
#elif __has_include(<experimental/filesystem>)
#include <experimental/filesystem>
namespace fs = std::experimental::filesystem;
#endif

这种写法很常见，尤其是兼容不同标准库实现时。

4.2 第三方库是否存在

#if __has_include(<spdlog/spdlog.h>)
#include <spdlog/spdlog.h>
#define USE_SPDLOG 1
#else
#define USE_SPDLOG 0
#endif

4.3 平台差异处理

1
2
3

#if __has_include(<unistd.h>)
#include <unistd.h>
#endif

5. 和宏判断有什么区别？

有些人会把它和 #ifdef 混在一起，但它们判断的对象不一样：

#ifdef XXX：判断宏是否定义
__has_include(...)：判断头文件是否能被包含

所以两者用途并不冲突。

6. 一个更完整的兼容示例

#include <iostream>

#if __has_include(<string_view>)
#include <string_view>
using TextView = std::string_view;
#else
#include <string>
using TextView = const std::string&;
#endif

int main()
{
    std::cout << "ok" << std::endl;
    return 0;
}