CMake Tools 插件本身不负责编译，仅调度CMake；跨平台构建成败取决于CMakeLists.txt正确性、Kit选择准确性及buildDirectory隔离性。configure失败提示“No CMAKE_CXX_COMPILER”表明本地编译器未被CMake识别，需验证g++/cl.exe可用性、在VSCode中执行“CMake: Select a Kit”并扫描，Windows用户应安装Build Tools，macOS用户需正确配置xcode-select；头文件标红源于c_cpp_properties.json静态路径与CMake动态路径不一致，应启用CMAKE_EXPORT_COMPILE_COMMANDS ON生成compile_commands.json，并将C/C++配置提供者设为ms-vscode.cmake-tools；buildDirectory和sourceDirectory必须准确指向含CMakeLists.txt的源目录和独立构建目录，推荐使用${workspaceFolder}/build/${buildType}-${platform}格式；多CMakeLists.txt项目需显式设置CMAKE_SOURCE_DIR；运行报错常因架构不匹配、动态库路径缺失或launch.json中program路径错误，Linux/macOS需补LD_LIBRARY_PATH，macOS需校验CMAKE_OSX_ARCHITECTURES；交叉编译必须使用toolchain file而非仅切换Kit；configureOnOpen虽默认开启，但删build目录或改CMakeLists.txt后须手动触发“CMake: Configure”以更新缓存与IntelliSense。
CMake Tools 插件本身不负责编译，它只调度 CMake；真正决定能否跨平台构建的，是你的 CMakeLists.txt 是否写对、kit 是否选准、buildDirectory 是否隔离。
configure 失败：No CMAKE_CXX_COMPILER could be found 怎么办
这不是 VSCode 或插件的问题，而是 CMake 在 configure 阶段根本没找到可用的 C++ 编译器。CMake Tools 只是把 cmake -G ... 命令跑起来，后面全靠本地环境。
- 先在终端执行
g++ --version（Linux/macOS）或cl.exe（Windows + VS Build Tools），确认编译器真能调用 - VSCode 里按
Ctrl+Shift+P→ 输入CMake: Select a Kit，选带g++、Clang或Visual Studio字样的项；如果列表为空，点Scan for kits再试一次 - Windows 用户若没装完整 Visual Studio，务必装
Build Tools for Visual Studio（比 VS 轻量，自带cl.exe和vcvarsall.bat） - macOS 用户运行
xcode-select --install后，还需运行sudo xcode-select --switch /Applications/Xcode.app或对应 Command Line Tools 路径，否则 kit 扫描可能失败
头文件标红、IntelliSense 找不到第三方库（如 fmt、OpenCV）
根本原因是 c_cpp_properties.json 里的 includePath 是静态配置，而 CMake 通过 find_package() 解析出的头文件路径是动态的——每次 configure 都可能不同。
- 删掉手写的
c_cpp_properties.json，改用 CMake 自动生成的compile_commands.json - 在
CMakeLists.txt里project()后加一行：set(CMAKE_EXPORT_COMPILE_COMMANDS ON) - 用 CMake Tools 点击
Build（或手动执行cmake --build build），确保build/compile_commands.json生成成功 - VSCode 设置中搜索
C_Cpp > Configuration Provider，选ms-vscode.cmake-tools（不是默认的Default） - 重启窗口，或执行命令
C/C++: Reset IntelliSense Database
buildDirectory 和 sourceDirectory 设错导致反复 configure 或找不到 CMakeLists.txt
这两个路径决定 CMake Tools 在哪执行 cmake 命令、往哪写缓存、从哪读 CMakeLists.txt。设错后，插件可能在 build/ 下找源码，也可能把缓存写进 src/ 目录污染源码。
立即学习“C++免费学习笔记（深入）”；
-
sourceDirectory必须指向含CMakeLists.txt的目录，典型值是${workspaceFolder}或${workspaceFolder}/src -
buildDirectory推荐用带变量的绝对路径，例如${workspaceFolder}/build/${buildType}-${platform}，避免 Debug/Release 构建互相覆盖 - Windows 上路径分隔符统一用
/，别写\；${workspaceFolder}\build会被 CMake Tools 解析失败 - 项目有多个
CMakeLists.txt（如子模块），必须在设置里显式配cmake.configureSettings→CMAKE_SOURCE_DIR，否则插件会乱猜入口
run 报错：exec format error 或找不到动态库
构建成功 ≠ 能运行。常见于架构不匹配（如 Apple Silicon 上生成了 x86_64 二进制）、运行时找不到依赖库、或 launch.json 指向错误路径。
- 检查
launch.json中program字段是否指向${workspaceFolder}/build/xxx下刚生成的可执行文件（不是src/下的源码） - macOS 上出现
exec format error，大概率是CMAKE_OSX_ARCHITECTURES设错了；在CMakeLists.txt中加set(CMAKE_OSX_ARCHITECTURES "arm64")或直接删掉该设置让系统自动推断 - Linux/macOS 下用
find_package(OpenCV)后运行报libopencv_core.so: cannot open shared object file，需在launch.json的env字段补上："LD_LIBRARY_PATH": "/path/to/opencv/lib:$LD_LIBRARY_PATH" - 交叉编译（如 ARM Linux）必须用
toolchain file（传给 CMake 的-DCMAKE_TOOLCHAIN_FILE=参数），而不是靠 kit 切换——kit 只管宿主机编译器，不管目标平台 ABI
最常被忽略的一点：CMake Tools 的 configureOnOpen 默认开启，但如果你手动删过 build/ 目录，或改过 CMakeLists.txt，它不会自动重新 configure；得手动点一次 CMake: Configure，否则 compile_commands.json 和 IntelliSense 就是旧的。
