使用CMake配置Visual Studio C++项目时如何保留磁盘文件结构

你遇到的交互异常本质是两个因素叠加导致的：

• 现有CMake配置没有将include目录纳入项目源文件列表，且源文件收集逻辑不支持动态感知磁盘上的文件变化，VS无法识别你期望的目录结构
• VS加载CMake项目时默认使用虚拟解决方案视图，这种视图的分组是CMake生成的逻辑筛选器，和磁盘物理路径没有强绑定，右键新建文件只会生成在虚拟路径下，不会对应到实际磁盘目录

1. 修正CMakeLists.txt配置 #

替换原有配置，解决源文件收集、输出路径隔离的问题：

cmake_minimum_required(VERSION 3.20)

# 基础路径常量
set(sourceDirectory   src)
set(includeDirectory  include)
set(targetName        vulkan-tutorial)
set(targetVersion     1.0.0)

# 强制所有构建输出落到项目根目录的build文件夹，完全不污染源目录
set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_SOURCE_DIR}/build/bin)
set(CMAKE_LIBRARY_OUTPUT_DIRECTORY ${CMAKE_SOURCE_DIR}/build/lib)
set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY ${CMAKE_SOURCE_DIR}/build/lib)
# 禁止在源目录生成任何构建缓存，从配置层面杜绝源目录污染
set(CMAKE_DISABLE_SOURCE_CHANGES ON)
set(CMAKE_DISABLE_IN_SOURCE_BUILD ON)

project(${targetName} VERSION ${targetVersion})

# 递归收集所有源文件+头文件，加CONFIGURE_DEPENDS自动感知磁盘上的新增/删除文件
file(GLOB_RECURSE projectSources CONFIGURE_DEPENDS
  ${sourceDirectory}/*.cpp
  ${includeDirectory}/*.h
  ${includeDirectory}/*.hpp
)

# 把所有收集到的文件(含头文件)显式关联到可执行目标
add_executable(${targetName} ${projectSources})

# 配置头文件搜索路径
target_include_directories(${targetName} PRIVATE ${includeDirectory})

关键调整逻辑：

• 用GLOB_RECURSE替代多层嵌套的手动GLOB写法，减少冗余配置
• 加CONFIGURE_DEPENDS参数，CMake会在每次构建时自动检查目录变化，把新增的cpp/h文件自动加入编译列表，不需要手动修改CMakeLists
• 显式把头文件纳入源文件列表，VS才会识别include目录为项目的正式交互目录
• 开启禁止源内构建的开关，哪怕误操作也不会在项目根目录生成零散的构建文件

2. 调整VS端的项目视图设置 #

打开VS加载项目后，按以下步骤操作：

• 先进入“CMake设置”面板，把构建目录设置为${projectDir}/build，确认所有中间文件、缓存、输出全都会落在build目录下，保存后等待VS自动完成配置加载
• 打开解决方案资源管理器，点击顶部工具栏的“切换视图”按钮，把默认的“解决方案视图”切换为文件夹视图

这个视图是直接映射你磁盘上的真实目录结构，不是CMake生成的虚拟筛选器，切换后你看到的文件夹结构和资源管理器里的完全一致，右键任意文件夹新建文件、子目录时，会直接在对应的磁盘路径下创建文件，完全符合使用预期。

• 不要依赖VS的筛选器分组功能实现目录映射：筛选器是纯逻辑的虚拟分组，和磁盘路径没有绑定，在筛选器里新建文件默认会落到项目根目录，根本无法实现自动路径匹配
• 不要把CMake缓存放在项目根目录：这种做法不仅会污染项目结构，还会导致VS把根目录当成构建临时目录，打乱正常的目录映射
• 不要省略头文件的收集：如果头文件不加入target的源文件列表，VS不会识别include目录的存在，哪怕切到文件夹视图也无法获得正常的项目交互能力

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