CMake Tips - 在Visual Studio中按目录结构自动创建Filters(Source Groups)

CMake技巧：在VS中自动创建按目录结构的Filters

最新推荐文章于 2025-05-30 23:47:55 发布

最新推荐文章于 2025-05-30 23:47:55 发布 · 1.7k 阅读

文章标签：

#c/c++

本文介绍了如何使用CMake的source_group()命令结合file()和string()命令，自动按目录结构为Visual Studio工程生成Filters，以方便管理和查找大型项目的源文件。通过定义宏source_group_by_dir并在CMakeLists.txt中调用，可以实现这一功能。

CMake作为构建系统可以轻松生成Visual Studio工程，这让我们的新项目可以不必维护一组专门的Visual Studio工程文件和sln文件了。但是CMake默认生成的工程文件中，只是笼统区分了头文件和其他源文件。对于大型项目，要在众多的源文件中找到想要的那个是很恼火的事情。对此，Visual Studio提供了filter机制来分类显示源文件。对于手工维护工程文件的项目，我们可以自己添加filter，然后提交到代码库，并与其他成员共享。
但是，在使用CMake后，手工维护filter是不现实的。CMake也提供了可以生成filter的机制，就是source_group()命令。结合source_group(), file(), string()等命令，我们可以让实现CMake自动按目录结构生成filter。
方法很简单，代码如下：

macro(source_group_by_dir source_files)
if(MSVC)
set(sgbd_cur_dir ${CMAKE_CURRENT_SOURCE_DIR})
foreach(sgbd_file ${${source_files}})
string(REGEX REPLACE ${sgbd_cur_dir}/$.*$ \\1 sgbd_fpath ${sgbd_file})
string(REGEX REPLACE "$.*$/.*" \\1 sgbd_group_name ${sgbd_fpath})