cmake tools 扩展未安装或未启用导致 vscode 无法识别 cmake 项目；必须通过 open folder 打开含合法 cmakelists.txt 的根目录，并正确选择 kit 才能触发构建与调试功能。
CMake Tools 扩展没装或没启用，CMakeLists.txt 就只是个文本文件，VSCode 根本不会把它当构建入口。
为什么 CMake: Build 命令根本不出现在命令面板里
这不是插件“不好用”，而是 VSCode 没识别出这是一个 CMake 项目。核心条件只有两个：CMakeLists.txt 必须在你用 File → Open Folder 打开的根目录下，且内容至少包含 cmake_minimum_required(VERSION 3.10) 和 project(...)。
常见卡点：
- 只双击打开了
CMakeLists.txt文件，而不是整个文件夹 —— 这样 VSCode 不会加载任何项目上下文 -
CMakeLists.txt放在src/或build/子目录里，VSCode 默认不递归扫描 - 扩展装的是
twxs.cmake（语法高亮用）但漏了ms-vscode.cmake-tools（构建逻辑用） - 扩展已安装但被手动禁用了，右下角状态栏看不到
Kit: [Unspecified]或Build Target字样
configure 报错 “Unknown command ‘find_package’” 的真实原因
这个错误和 CMakeLists.txt 本身完全无关，是底层 cmake 可执行文件没被正确调用导致的。根本原因是没选 Kit —— 即没告诉 CMake Tools 该用哪个编译器、哪个 cmake 二进制文件、哪些环境变量。
实操路径：
- 按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux），输入并执行CMake: Select a Kit - 如果列表为空，先运行
CMake: Scan for Kits，再重启 VSCode（尤其 macOS 上 Xcode command line tools 更新后常需重启） - 选中带明确编译器标识的项，例如
Clang 16.0.6 (x86_64-apple-darwin24.0.0)或GCC 13.2.0 (/usr/bin/g++) - 之后再执行
CMake: Configure，错误就会消失 —— 因为 Kit 绑定了完整的工具链路径，find_package才能定位到模块
构建输出的可执行文件找不到，或者 launch.json 调试失败
不是路径写错了，而是 VSCode 默认把构建产物放在 build/ 下，但 launch.json 里写的路径可能还是默认的 ./myapp 或 ./out/myapp。
关键动作：
- 确认构建目录：执行
CMake: Set Build Directory，设为build（推荐）或out/debug等显式路径 - 构建完成后，去对应目录里找生成的文件名 —— 它由
add_executable(MyApp ...)中第一个参数决定，不是main.cpp名字 - 编辑
.vscode/launch.json，把program字段改成绝对路径或相对路径，例如"${workspaceFolder}/build/MyApp" - 别依赖自动检测：VSCode 的调试器不会自己猜构建输出在哪，必须显式指向
最易被忽略的一点：CMake Tools 默认启用 cmake.configureOnOpen，但如果你删过 build/ 目录或改过 CMakeLists.txt，它不会自动重配置 —— 必须手动触发一次 CMake: Configure，否则后续所有构建和调试都基于旧缓存，行为不可预测。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
