CMake中protobuf_generate_cpp未调用protoc问题求助

问题根源 #

CMake 3.25.x版本对Protobuf模块的代码生成命令做了兼容性调整：protobuf_generate_cpp默认行为变更导致不触发protoc调用；protobuf_generate则废弃了旧的cpp_out参数格式，改用新的参数配置。

修复选项 #

选项1：适配protobuf_generate新语法 #

CMake 3.25+要求protobuf_generate通过LANGUAGE指定目标语言，用OUT_VAR接收生成文件列表，示例配置如下：

find_package(Protobuf REQUIRED)

# 声明你的proto文件集合
set(PROTO_FILES foo.proto bar.proto)

# 生成C++代码
protobuf_generate(
    LANGUAGE cpp
    OUT_VAR PROTO_SOURCES
    OUT_VAR PROTO_HEADERS
    PROTOS ${PROTO_FILES}
)

# 将生成文件关联到目标
add_executable(your_app main.cpp ${PROTO_SOURCES} ${PROTO_HEADERS})
target_link_libraries(your_app PRIVATE ${Protobuf_LIBRARIES})
# 必须添加二进制目录，否则找不到生成的头文件
target_include_directories(your_app PRIVATE ${CMAKE_CURRENT_BINARY_DIR})

选项2：恢复protobuf_generate_cpp旧行为 #

在find_package(Protobuf)前添加兼容开关，强制启用旧版protobuf_generate_cpp的调用逻辑：

# 强制使用旧版protobuf_generate_cpp行为
set(CMAKE_PROTOBUF_GENERATE_CPP_APPEND_PATH OFF)
find_package(Protobuf REQUIRED)

# 保留你原来的protobuf_generate_cpp调用
protobuf_generate_cpp(PROTO_SRCS PROTO_HDRS ${PROTO_FILES})

选项3：手动调用protoc兜底 #

如果上述方案均无效，直接通过自定义命令调用protoc生成代码，完全控制生成流程：

find_package(Protobuf REQUIRED)

set(PROTO_FILES foo.proto)
set(OUTPUT_DIR ${CMAKE_CURRENT_BINARY_DIR})

foreach(PROTO ${PROTO_FILES})
    get_filename_component(PROTO_BASE ${PROTO} NAME_WE)
    add_custom_command(
        OUTPUT ${OUTPUT_DIR}/${PROTO_BASE}.pb.cc ${OUTPUT_DIR}/${PROTO_BASE}.pb.h
        COMMAND ${Protobuf_PROTOC_EXECUTABLE}
        ARGS --cpp_out=${OUTPUT_DIR} ${CMAKE_CURRENT_SOURCE_DIR}/${PROTO}
        DEPENDS ${PROTO}
        COMMENT "Generating protobuf code for ${PROTO}"
    )
    list(APPEND PROTO_SRCS ${OUTPUT_DIR}/${PROTO_BASE}.pb.cc)
endforeach()

add_executable(your_app main.cpp ${PROTO_SRCS})
target_link_libraries(your_app PRIVATE ${Protobuf_LIBRARIES})
target_include_directories(your_app PRIVATE ${OUTPUT_DIR})

额外注意事项 #

• 确保protoc版本与CMake的Protobuf模块版本匹配，避免跨版本兼容问题
• 确认CMAKE_CURRENT_BINARY_DIR或自定义输出目录被添加到目标的包含路径中

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