CMake: Configure失败主因是kit未选对或未扫描到，而非CMake未安装；需通过CMake: Scan for Kits和CMake: Select a Kit手动选择匹配的编译器，确保CMakeLists.txt位于项目根目录且内容完整，build目录应由插件自动生成而非手动创建。
VS Code 用 CMake 不是“配置 CMake”，而是让 CMake Tools 插件识别你的项目结构和编译器——关键在 CMakeLists.txt、kit 和 build directory 三者对齐。
为什么 CMake: Configure 总失败？
常见现象：点击 CMake: Configure 后报错 Could not find a package configuration file 或直接卡住不动。
- 根本原因不是 CMake 没装好，而是 VS Code 没找到可用的
kit（即编译器+工具链组合） -
CMake Tools插件启动时会扫描PATH下的gcc、g++、cl.exe等，但若 MinGW 或 MSVC 的bin目录没进系统环境变量，就扫不到 - 即使扫到了，也可能因版本冲突被忽略（比如同时装了 MinGW 8.1 和 11.2，插件默认选旧的，而你的
CMakeLists.txt用了CXX_STANDARD 20）
实操建议：F1 → 输入 CMake: Scan for Kits，再执行 CMake: Select a Kit，手动挑一个带明确路径的（如 GNU 8.1.0 (x86_64-w64-mingw32-g++)），别依赖自动选。
CMakeLists.txt 放哪？必须叫这个名字吗？
必须放在项目根目录（即你用 File → Open Folder 打开的那个文件夹），且文件名严格为 CMakeLists.txt（大小写敏感，无扩展名）。
- 如果放错位置（比如在
src/子目录里），CMake Tools 会提示No active folder or workspace - 内容至少得有三行：
cmake_minimum_required(VERSION 3.18)、project(MyProject)、add_executable(...)，缺一行都触发不了 Configure - OpenCV 等第三方库的
find_package(OpenCV REQUIRED)要求OpenCV_DIR环境变量或PATH包含OpenCVConfig.cmake，否则报Could not find OpenCV
build 目录该不该手动创建？
不该。CMake Tools 默认在项目根目录下建 build/，但 Windows 用户常因权限或路径问题失败。
- 典型错误：
Permission denied或Failed to create directory: build，多因项目路径含中文、空格或在C:\根目录 - 解决方法：把项目放在纯英文路径（如
D:\cpp\myapp），然后在命令面板运行CMake: Delete Cache and Reconfigure - 想换 build 路径？在
settings.json里加："cmake.buildDirectory": "${workspaceFolder}/out/build"，别手动生成空文件夹
调试时找不到 symbol 或断点失效
不是 GDB 配置问题，大概率是编译没开调试信息。
- 检查
CMakeLists.txt是否有set(CMAKE_BUILD_TYPE Debug)，或者你在 VS Code 底部状态栏看到的是Release而非Debug - MinGW 下必须确保链接时带
-g，CMake 默认只在Debug模式下加，切到RelWithDebInfo也能保留符号 - 如果用了
add_compile_options(-O2)，会干扰调试，临时注释掉再试
真正麻烦的是 OpenCV 这类预编译库——你用 MinGW 编译的 OpenCV 必须和项目用同一套 MinGW（seh vs sjlj、posix vs win32 threading），混用直接导致 undefined reference 或运行时崩溃，这点极容易被忽略。
