如何为CMake中各目标的构建输出生成独立日志文件？

CMake本身没有原生支持为每个目标单独生成构建日志的功能，但可以通过以下几种方式实现需求：

方法一：利用底层构建工具的特性或脚本拆分 #

不同的构建后端（如Makefile、Ninja）可以结合脚本实现日志拆分：

• Makefile生成器：
  先通过make命令捕获完整构建日志，再用脚本拆分到单个目标文件：

  make -j$(nproc) 2>&1 | tee build_all.log
  # 从总日志中提取每个目标的日志（需根据实际输出格式调整正则）
  grep -E "Building target.*" build_all.log | awk '{print $NF}' | sort -u | xargs -I {} sh -c "grep -A 100 -B 5 {} build_all.log > build_{}.log"
  

  这种方式无需修改CMake配置，适合快速临时使用。

• Ninja生成器：
  Ninja支持生成结构化的构建日志，再通过脚本解析拆分：

  ninja -j$(nproc) --log build_full.log
  

  生成的build_full.log包含每个目标的构建步骤和输出，可以用Python等脚本解析，将对应目标的内容写入单独的build_target_name.log文件。

方法二：通过CMake自定义目标规则 #

可以在CMake中为每个目标添加自定义编译/链接选项，将输出定向到独立日志：

function(add_target_with_log target)
    # 创建目标
    add_executable(${target} ${ARGN})
    # 定义日志文件名
    set(log_file "${CMAKE_BINARY_DIR}/build_${target}.log")
    # 捕获C++编译输出（GCC/Clang适用）
    target_compile_options(${target} PRIVATE
        $<$<COMPILE_LANGUAGE:CXX>:--verbose 2>&1 > ${log_file}
    )
    # 捕获链接输出
    set_target_properties(${target} PROPERTIES
        LINK_FLAGS "--verbose 2>&1 >> ${log_file}"
    )
endfunction()

# 替代原生add_executable使用
add_target_with_log(my_app src/main.cpp)
add_target_with_log(my_lib src/lib.cpp)

注意：并行构建时需确保日志文件路径唯一，避免写入冲突；不同编译器的verbose参数可能不同，需根据实际情况调整。

方法三：结合CTest捕获构建日志 #

如果项目使用CTest，可以为每个目标创建构建测试用例，自动保存日志：

# 为目标my_app添加构建测试
add_test(NAME Build_my_app
    COMMAND ${CMAKE_COMMAND} --build ${CMAKE_BINARY_DIR} --target my_app
    WORKING_DIRECTORY ${CMAKE_BINARY_DIR}
)
# 配置日志属性
set_tests_properties(Build_my_app PROPERTIES
    LOG_OUTPUT_ON_FAILURE ON
    LOG_FILE "${CMAKE_BINARY_DIR}/build_my_app.log"
)

这种方式适合CI环境，构建失败时会自动保留对应目标的日志，无需手动拆分。

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