基于ModernCppStarter模板创建项目后无法找到头文件求助

核心原因 #

这个模板依赖的doctest和cxxopts是通过CMake的动态依赖拉取机制（如CPM或FetchContent）管理的，克隆仓库时不会自动下载依赖文件，必须先让CMake完成配置流程，才能拉取依赖并让IDE识别到头文件路径。

具体解决步骤 #

1. 手动触发CMake依赖下载 #

打开终端，进入仓库根目录，执行以下命令：

# 创建build目录（若不存在）
mkdir build && cd build
# 执行CMake配置，自动拉取所需依赖
cmake ..

等待命令执行完成，doctest和cxxopts的源码会被自动下载到本地CMake缓存或指定的依赖目录中。

2. 重新加载IDE的CMake配置 #

• CLion：点击顶部工具栏的「Reload CMake Project」刷新图标，或右键点击CMakeLists.txt选择「Reload CMake Project」。
• VS Code：打开命令面板（Ctrl+Shift+P），依次执行「CMake: Configure」（选择对应编译器）和「CMake: Reload CMake Project」。

3. 问题排查（若仍报错） #

• 删除build目录，重新执行cmake配置命令
• 确认网络正常（依赖需从GitHub拉取）
• 检查IDE的CMake工具链配置是否正确（比如使用系统默认CMake还是自定义安装版本）

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