装完CMake后应先验证编译器并运行最小闭环：Linux用sudo apt install build-essential，macOS执行xcode-select --install，Windows确保gcc在PATH；再创建三行CMakeLists.txt和含printf或cout的main.cpp/main.c。
装完 cmake 后，别急着写复杂项目——先跑通一个能编译、能执行的最小闭环，否则后续所有配置都可能卡在“找不到编译器”或“CMakeLists.txt 语法错”上。
确认编译器是否就位
CMake 本身不编译代码，它只生成构建文件（比如 Makefile），真正干活的是 gcc、clang 或 MSVC。如果没装编译器，cmake . 会直接报错：Could not find compiler set in environment variable CC 或类似提示。
- Linux（Ubuntu/Debian）：运行
sudo apt install build-essential（含gcc、g++、make） - CentOS/RHEL：运行
sudo yum groupinstall "Development Tools" - macOS：装 Xcode Command Line Tools，执行
xcode-select --install - Windows（MinGW）：确保
gcc在 PATH 中，验证用gcc --version
验证方式：终端输入 gcc --version 和 cmake --version 都有输出，才算齐活。
写最简 CMakeLists.txt 和源码
不要从网上抄一长串带 find_package 的模板——新手第一份 CMakeLists.txt 只需要三行，且必须和源文件放同一目录。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 新建文件
main.cpp（C++）或main.c（C），内容仅含printf("OK\n");或std::cout - 同目录下新建
CMakeLists.txt，内容严格如下（注意空格和括号）：cmake_minimum_required(VERSION 3.10) project(hello) add_executable(hello main.cpp)
- 版本号别写太低（如
2.8），新版 CMake 对旧语法支持弱，3.10是当前安全下限
用外部构建目录避免污染源码
直接在源码目录执行 cmake . 会把 CMakeCache.txt、CMakeFiles/ 等中间文件塞进项目根目录，git 提交时容易误提交。正确做法是建独立构建目录：
- 执行：
mkdir build && cd build - 再运行：
cmake ..（注意是两个点，指向上级源码目录） - 成功后当前目录会出现
Makefile；失败则看终端最后一行红字错误，90% 是编译器路径、源文件名拼写或add_executable参数不匹配 - 接着
make编译，生成的可执行文件默认在build/下，不是源码目录
常见卡点：为什么 cmake .. 没反应或报错？
这不是 CMake 问题，而是环境或配置没对齐。重点盯这几个信号：
-
CMake Error at CMakeLists.txt:3 (add_executable): Cannot find source file "main.cpp"→ 检查文件名大小写（Linux 区分Main.cpp和main.cpp）、路径是否真在..目录下 -
-- The CXX compiler identification is unknown→ 编译器没装或不在 PATH，which g++应有输出 - 执行
cmake ..后只有-- Configuring incomplete, errors occurred!→ 错误信息一定在最后几行，别只看开头的绿色日志 - 生成了
Makefile但make报undefined reference to `main'→ 源文件里没写main()函数，或用了int main(int argc, char** argv)却漏了return 0;
真正麻烦的从来不是语法，而是编译器不可见、源文件路径错位、构建目录混用这三件事。跑通第一个 hello 后，再加 set(CMAKE_CXX_STANDARD 17) 或链接库才不会迷失方向。
