Windows下CMake配置头文件目录后仍报C1083找不到头文件错误

头文件找不到的报错完全由CMake配置的笔误导致，和C++源码的include语句无关，核心错误有2个，附带1个不影响本次报错但会导致其他问题的笔误：

• 核心错误1：头文件搜索路径引用了不存在的CMake变量
  配置中写的${CMAKE_CURRENT_SRC_DIR}是错误变量名，CMake内置的、指向当前CMakeLists.txt所在目录的变量为CMAKE_CURRENT_SOURCE_DIR，错误的变量名会被解析为空字符串，最终传给编译器的头文件搜索路径是盘符根目录下的/include，和你项目内的include文件夹完全无关，自然找不到main.h。
• 核心错误2：源文件路径配置逻辑错误
  CMake中所有相对路径的解析基准是当前CMakeLists.txt的存放目录，和执行cmake命令的终端工作目录无关。你的CMakeLists.txt放在项目根目录，和src文件夹同级，配置中写的../src/main.cpp会被解析为根目录上一级文件夹下的src路径，属于错误路径，本次能定位到main.cpp是旧构建缓存导致的异常结果。
• 附加笔误：C标准配置的变量名错误
  配置中写的set(CXX_STANDARD 17)漏了CMAKE_前缀，正确变量为CMAKE_CXX_STANDARD，当前你的C17配置根本没有生效，只是本次报错和这个问题无关。

1. 保留main.cpp中#include "main.h"的写法，不需要修改为带include/前缀的形式。
2. 将根目录下的CMakeLists.txt替换为以下正确配置：

cmake_minimum_required(VERSION 3.10)
# 修正C++标准配置变量
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
project(hello VERSION 1.0)
# 修正源文件相对路径，指向同层级src目录下的main.cpp
add_executable(hello src/main.cpp)
# 修正头文件搜索路径变量，指向项目根目录下的include文件夹
target_include_directories(hello PUBLIC ${CMAKE_CURRENT_SOURCE_DIR}/include)

3. 清空旧构建缓存重新编译，避免旧的错误配置残留：
   在项目根目录（存放src、include、CMakeLists.txt的目录）打开终端，执行以下命令：

# 删除旧的build目录
Remove-Item -Recurse -Force build -ErrorAction SilentlyContinue
# 新建build目录并重新生成构建文件
mkdir build
cd build
cmake ..
# 执行编译
cmake --build .

注意：只要修改了CMakeLists.txt中路径、编译选项相关的配置，必须清空旧build目录的缓存重新生成配置，否则CMake会复用之前的错误缓存，哪怕配置写对了也可能继续报原有错误。

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