CMake中如何以列表形式添加子目录？若无可行方案，subdirs命令被废弃的原因是什么？

Great question—this is definitely a common pain point when managing larger CMake projects. Let's break this down into two parts:

1. 用列表批量添加子目录的方法 #

虽然add_subdirectory本身不支持直接传入列表，但你可以用CMake的foreach循环轻松实现批量调用，这是社区里最常用的替代方案，既简洁又符合现代CMake的最佳实践：

# 定义你的子目录列表
set(LOCAL_SUBDIRS Helpers Lib1 Lib2)

# 遍历列表逐个调用add_subdirectory
foreach(subdir IN LISTS LOCAL_SUBDIRS)
    add_subdirectory(${subdir})
endforeach()

如果需要给某些子目录传递额外参数（比如EXCLUDE_FROM_ALL），你也可以灵活调整循环逻辑，比如给特定子目录单独设置：

set(LOCAL_SUBDIRS Helpers Lib1 Lib2)
set(EXCLUDE_SUBDIRS Lib2)

foreach(subdir IN LISTS LOCAL_SUBDIRS)
    if(subdir IN_LIST EXCLUDE_SUBDIRS)
        add_subdirectory(${subdir} EXCLUDE_FROM_ALL)
    else()
        add_subdirectory(${subdir})
    endif()
endforeach()

这种方法完全兼容现代CMake的所有特性，而且保持了代码的可读性和可维护性。

2. subdirs命令被废弃的原因 #

CMake官方标记subdirs为废弃，主要是因为它的设计不符合现代CMake追求的可预测性、模块化和透明性原则，具体问题包括：

• 路径行为不一致：subdirs会修改当前的CMAKE_CURRENT_SOURCE_DIR和CMAKE_CURRENT_BINARY_DIR，这意味着在调用subdirs之后，后续的路径相关代码会意外指向最后一个子目录的路径，很容易引发隐蔽的错误。而add_subdirectory不会改变当前目录，始终保持调用者的上下文。
• 隐含行为过多：subdirs有一些默认的隐含逻辑（比如自动递归处理子目录中的CMakeLists.txt，或者默认添加子目录到构建目标），这些行为不够明确，难以调试和控制。现代CMake更倾向于显式的命令调用，让开发者清晰知道每一步的作用。
• 缺乏现代特性支持：subdirs不支持add_subdirectory的一些关键特性，比如EXCLUDE_FROM_ALL参数（用于将子目录排除在默认构建目标之外），也无法很好地配合CMake的目标(TARGET)系统进行依赖管理。

总之，add_subdirectory + foreach的组合是更安全、更灵活的选择，完全可以替代subdirs的列表需求，同时避免了废弃命令带来的兼容性风险。

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