为何VS Code中仅子目录CMakeLists.txt无法配置，根目录添加后可行？

环境信息 #

• 操作系统：Windows 10
• VS Code版本：1.83.1
• CMake版本：3.27.6
• VS Code扩展CMake Tools版本：1.15.31

项目结构 #

my_project/
-- my_project/
---- CMakeLists.txt
---- src/
------ main.cpp

代码文件内容 #

main.cpp #

// main.cpp
#include <iostream>

int main(){
    std::cout << "Bismillah hello world\n" << std::endl;
    return 0;
}

子目录CMakeLists.txt #

cmake_minimum_required(VERSION 3.10)
project(my_project)

add_executable(my_project_main src/main.cpp)

问题现象 #

按下Ctrl + Shift + P选择CMake: Configure，选择子目录的CMakeLists.txt后，弹出提示：

"Configure failed. Would you like to attempt to configure with the CMake Debugger?"

点击"Debug"按钮后仍显示相同提示。但在根目录添加如下CMakeLists.txt后，配置成功：

cmake_minimum_required(VERSION 3.10)
project(root_of_my_project)

add_subdirectory(my_project)

原因分析 #

VS Code的CMake Tools扩展默认将当前打开的工作区根目录作为CMake的源码树根目录。当你打开外层my_project目录作为工作区时，扩展默认期望根目录存在CMakeLists.txt作为构建入口。

当你选择子目录的CMakeLists.txt时，CMake尝试将子目录作为源码根，但此时扩展的工作区路径与CMake的源码根路径不匹配，加上默认构建目录的路径解析逻辑冲突，最终导致配置失败。而根目录添加CMakeLists.txt后，扩展找到了符合预期的入口点，通过add_subdirectory关联子目录的构建逻辑，整个路径解析流程正常，因此配置成功。

解决方案：仅使用子目录CMakeLists.txt完成配置 #

当然可以，有两种可行方式：

1. 切换工作区至子目录：关闭当前工作区，直接打开内层的my_project目录（即包含目标CMakeLists.txt的目录），再执行CMake: Configure，此时扩展会直接识别该目录下的CMakeLists.txt作为构建入口，配置可正常完成。
2. 手动指定源码根目录：若坚持使用外层my_project作为工作区，按下Ctrl + Shift + P选择CMake: Select Source Directory，明确选择内层的my_project目录，之后再执行CMake: Configure即可。

内容的提问来源于stack exchange，提问作者Bayu Kanugrahan Luknanto