C++项目CMake配置下无法引入Protobuf生成头文件问题排查

头文件搜索失败的核心原因是构建系统没有把Protobuf生成头文件所在的目录配置为公共包含路径：

• PROTOBUF_GENERATE_CPP 会将生成的protofile.pb.h、protofile.pb.cc输出到Proto子模块对应的构建目录，即Build/Proto/路径下
• 你在源码中使用#include <Proto/protofile.pb.h>引入头文件，要求编译器的头文件搜索路径包含Build根目录，才能匹配到Proto/子路径下的生成头文件
• 现有配置仅用目录级别的INCLUDE_DIRECTORIES添加了Protobuf自身的头文件路径，既没有包含生成头文件的目录，也没有将包含路径传递给链接protoLib的上层目标，因此编译器无法定位到头文件

1. 修改Proto/目录下的CMakeLists.txt，替换为如下配置：

INCLUDE(FindProtobuf)
# 显式指定proto文件的绝对路径，避免相对路径解析异常
PROTOBUF_GENERATE_CPP(PROTO_SRC PROTO_HDRS ${CMAKE_CURRENT_SOURCE_DIR}/protofile.proto)

add_library(protoLib ${PROTO_SRC} ${PROTO_HDRS})
# 配置目标级公共包含路径，所有链接protoLib的目标会自动继承这些路径
target_include_directories(protoLib PUBLIC
    ${PROTOBUF_INCLUDE_DIR} # Protobuf自身头文件路径
    ${CMAKE_CURRENT_BINARY_DIR}/.. # 对应Build根目录，匹配<Proto/protofile.pb.h>的引入路径
)
# 自动链接Protobuf依赖库，上层目标无需重复配置链接
target_link_libraries(protoLib PUBLIC ${PROTOBUF_LIBRARIES})

原配置中SET_SOURCE_FILES_PROPERTIES(PROTO_SRC PROTO_HDRS PROPERTIES GENERATED TRUE)为冗余配置，PROTOBUF_GENERATE_CPP宏会自动为生成文件添加GENERATED属性，可直接删除。
根目录下的CMakeLists.txt无需修改，原有add_subdirectory(Proto)与target_link_libraries(${TARGET} PUBLIC protoLib)配置符合要求。

2. 清空原有Build目录的缓存文件，重新执行CMake配置与编译即可。

如果不想调整CMake包含路径，也可以直接将file1.cpp中的引入语句改为#include "protofile.pb.h"，但这种方式会破坏头文件引入的路径一致性，不推荐在中大型项目中使用。

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