CMake中add_custom_command无法执行及依赖报错问题求助

问题核心原因 #

add_dependencies的参数必须是CMake目标（比如add_executable/add_library/add_custom_target创建的目标），你直接把add_custom_command生成的输出文件当作参数传入，CMake会判定这是个不存在的目标，从而触发报错。

修复后的最小可复现示例（MRE） #

项目结构 #

project_root/
├── CMakeLists.txt
├── src/
│   └── main.cpp
└── shaders/
    ├── a.cu
    └── b.cu

修复后的CMakeLists.txt #

cmake_minimum_required(VERSION 3.20)
project(CustomCommandDemo)

# 创建shader编译产物的输出目录
set(SHADER_OUTPUT_DIR ${CMAKE_BINARY_DIR}/compiled_shaders)
file(MAKE_DIRECTORY ${SHADER_OUTPUT_DIR})

# 定义需要处理的shader文件列表
set(SHADER_FILES
    shaders/a.cu
    shaders/b.cu
)

# 创建总自定义目标，确保shader编译会默认执行
add_custom_target(CompileShaders ALL)

# 遍历处理每个shader文件
foreach(SHADER ${SHADER_FILES})
    # 提取文件名（不含路径）
    get_filename_component(SHADER_NAME ${SHADER} NAME)
    # 定义编译后的输出文件路径
    set(OUTPUT_FILE ${SHADER_OUTPUT_DIR}/${SHADER_NAME}.spv)

    # 添加编译shader的自定义命令
    add_custom_command(
        OUTPUT ${OUTPUT_FILE}
        # 这里替换成你实际的编译命令（比如nvcc），当前用echo模拟
        COMMAND ${CMAKE_COMMAND} -E echo "Compiling ${SHADER} -> ${OUTPUT_FILE}"
        MAIN_DEPENDENCY ${SHADER}
        COMMENT "Processing shader: ${SHADER_NAME}"
    )

    # 为单个shader的输出文件创建临时目标（关键：把文件包装成CMake目标）
    add_custom_target(Compile_${SHADER_NAME} DEPENDS ${OUTPUT_FILE})
    # 将临时目标关联到总编译目标
    add_dependencies(CompileShaders Compile_${SHADER_NAME})
endforeach()

# 主程序可执行文件
add_executable(MainApp src/main.cpp)
# 让主程序等待shader编译完成后再构建
add_dependencies(MainApp CompileShaders)

关键修复点与错误分析 #

• 用自定义目标包装输出文件：add_custom_command的输出是普通文件，不能直接传给add_dependencies，必须通过add_custom_target把文件包装成CMake目标才能建立依赖
• 总目标统一管理：创建CompileShaders总目标，把所有单个shader的临时目标关联进来，避免主程序需要依赖多个零散目标
• ALL关键字的作用：给总目标加上ALL，确保它会随主程序自动编译，不需要手动指定执行该目标

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