C++规范项目结构下尖括号引入头文件找不到的问题咨询

C++ 编译器对头文件的搜索逻辑存在默认规则：使用尖括号<>引入头文件时，默认仅搜索系统标准库路径、编译器内置路径，不会自动扫描项目内部目录；使用双引号""引入头文件时，会优先搜索当前源文件所在目录，再搜索上述系统路径。要使用尖括号引入项目内头文件，只需将项目头文件所在目录通过编译参数告知编译器即可，Makefile 配置步骤如下：

1. 定义头文件路径变量
   在 Makefile 开头声明头文件搜索目录参数，符合标准canonical结构的C++项目通常将公开头文件放在根目录的include文件夹下，配置示例：

# 多个头文件目录可以多次追加 -I 参数，比如 -I./src/utils -I./third_party/xxx/include
INCLUDES := -I./include

2. 将参数加入编译规则
   在生成目标文件（.o）的编译命令中引入上述INCLUDES变量，示例编译规则：

CXX := g++
CXXFLAGS := -Wall -std=c++17

# %.o 目标文件的通用编译规则
%.o: %.cpp
	$(CXX) $(CXXFLAGS) $(INCLUDES) -c $< -o $@

注意事项 #

你通过-I指定的是头文件搜索的根路径，如果include目录下存在子目录层级，代码中引入头文件需要写相对于该根路径的完整路径。比如include/net/socket.h，代码中需写#include <net/socket.h>即可正常识别。

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