如何让#include <>忽略系统默认头文件路径？CMake项目编译异常解惑

咱们一个一个来解决你的两个问题：

问题1：如何让#include <>忽略系统默认头文件路径（/usr/include）？ #

要让编译器处理#include <>时跳过默认的系统头文件路径（比如/usr/include），可以通过gcc/g++的编译参数实现，分两种场景：

• 完全跳过所有系统头文件路径：使用-nostdinc参数，它会让编译器忽略所有默认的系统头文件目录（包括C和C标准库的路径）。如果是纯C项目，也可以用-nostdinc++，这个参数只会忽略C++标准库的路径，保留C标准库的路径，更灵活一些。
• 需要自定义系统头文件路径时：如果跳过默认路径后，你要指定自己的替代头文件路径，推荐用-isystem参数（而非普通的-I），因为-isystem会把路径标记为系统头文件路径，编译器会像处理默认系统路径一样对待它，避免报一些无关的警告。示例命令：

  g++ -nostdinc++ -isystem /path/to/your/custom/include your_code.cpp
  

在CMake项目里，你可以通过设置编译标志来配置：

# 针对C语言项目
set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -nostdinc")
# 针对C++语言项目
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -nostdinc++")

# 添加自定义系统头文件路径
include_directories(SYSTEM /path/to/your/custom/include)

⚠️ 注意：用了-nostdinc或-nostdinc++后，编译器找不到默认的标准库头文件（比如<iostream>、<stdio.h>），所以你要么自己提供替代的头文件，要么通过-isystem指定包含标准库的路径，否则编译肯定会报错。

问题2：为什么#include <>没有优先搜索/usr/include，反而找不到存在的json/json.h？ #

你的困惑核心在于gcc/g++对#include <>的搜索顺序，以及CMake的include_directories如何影响这个顺序，咱们拆解来看：

先明确搜索优先级 #

对于#include <file>，gcc的搜索顺序是：

1. 先搜所有通过-I指定的目录（按命令行里的顺序来）
2. 再搜默认的系统头文件目录（比如/usr/include）

而CMake的include_directories命令，本质就是给编译器添加-I参数。所以理论上，就算你错误设置了include_directories，编译器应该先去错误路径找，找不到再去/usr/include搜——那为什么会报错找不到？大概率是以下几种情况：

1. 交叉编译环境导致系统路径不匹配：如果你的项目是交叉编译（比如嵌入式开发），CMake可能配置了CMAKE_SYSROOT，此时编译器的默认系统头文件路径是${CMAKE_SYSROOT}/usr/include，而不是你主机上的/usr/include。你检查的是主机的路径有文件，但交叉编译的sysroot里并没有，所以编译器找不到。
2. 编译参数里加了-nostdinc/-nostdinc++：如果项目的CMakeLists里不小心加了这个参数，编译器会直接跳过默认系统路径，自然找不到/usr/include里的头文件。
3. 权限问题：虽然你确认/usr/include/json/json.h存在，但当前编译的用户可能没有读取该文件的权限（比如用普通用户编译，但文件权限限制了非root用户读取）。
4. 大小写拼写错误：Linux文件系统是大小写敏感的，如果代码里写的是#include <Json/Json.h>，但实际/usr/include里的是json/json.h，也会导致找不到。

快速验证方法 #

你可以在编译时加-v参数，让gcc输出详细的头文件搜索路径：

g++ -v your_source.cpp

查看输出里的#include <...> search starts here:部分，就能看到编译器实际会搜索哪些路径、顺序如何，这样就能快速定位问题出在哪。

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