如何通过CMake为Doxygen的INPUT参数配置多个目录路径

问题根因 #

你当前配置出错的核心原因是：set(DOXYGEN_INPUT_DIR "${DIR_1}" "${DIR_2}")会将该变量定义为CMake列表类型，列表元素默认用分号分隔。当执行Doxyfile模板替换时，变量会被展开为project_dir/dir_1;project_dir/dir_2，分号会被Doxygen识别为路径的一部分，最终就出现了你看到的路径拼接错误。
单个目录配置正常的原因是此时变量为普通字符串而非列表，不存在分号分隔符，替换后路径符合Doxygen要求。

补充疑问解答 #

你对set(DOXYGEN_INPUT_DIR ${DIR_1})作用的认知完全正确：CMake执行configure_file处理Doxyfile模板时，会将文件内的@DOXYGEN_INPUT_DIR@占位符替换为该变量的实际值。

解决方案 #

你只需要将多个目录转换为Doxygen支持的空格分隔格式即可，以下两种方案都符合你不能直接修改Doxyfile写入多个目录的规范要求：

方案1：直接拼接（目录数量固定时使用） #

直接将两个路径用空格拼接，额外加双引号兼容路径含空格的场景，修改DOXYGEN_INPUT_DIR的赋值语句即可：

# 替换原来的set(DOXYGEN_INPUT_DIR "${DIR_1}" "${DIR_2}")
set(DOXYGEN_INPUT_DIR "\"${DIR_1}\" \"${DIR_2}\"")

方案2：列表转字符串（后续需动态新增目录时使用） #

如果后续还要添加更多目录，用列表遍历的写法更易维护：

# 先定义所有需要加入的目录列表
set(DOXYGEN_INPUT_DIR_LIST "${DIR_1}" "${DIR_2}")
set(DOXYGEN_INPUT_DIR "")
# 遍历列表给每个路径套双引号，再用空格拼接
foreach(DIR ${DOXYGEN_INPUT_DIR_LIST})
    string(APPEND DOXYGEN_INPUT_DIR "\"${DIR}\" ")
endforeach()
# 去掉末尾多余的空格
string(STRIP ${DOXYGEN_INPUT_DIR} DOXYGEN_INPUT_DIR)

修改后重新执行CMake配置即可，Doxygen会正常识别两个独立的目录，配合你已经开启的RECURSIVE = YES参数，就能只遍历指定目录生成文档，避免全目录扫描的开销。

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