cmake ..报错“no CMAKE_CXX_COMPILER could be found”说明CMake未找到C++编译器，需先安装g++或cl并确保PATH包含其路径，或显式指定-DCMAKE_CXX_COMPILER；add_executable源文件路径必须严格相对于CMakeLists.txt所在目录。
直接运行 cmake 命令不报错，且能生成 Makefile 或构建目录内容，就说明首次构建流程走通了——但绝大多数人卡在 add_executable() 参数写错或源文件路径没对齐这一步。
cmake .. 报错“no CMAKE_CXX_COMPILER could be found”
这是新手最常遇到的阻断性错误，本质是 CMake 没找到可用的 C++ 编译器，不是 CMake 本身装错了。
- 先确认系统已安装编译器：
g++ --version（Linux/macOS）或cl（Windows VS 工具链） - 如果没装，Ubuntu/Debian 执行
sudo apt install build-essential；CentOS/RHEL 用sudo yum groupinstall "Development Tools" - 若已装但 CMake 还是找不到，显式指定编译器：
cmake -DCMAKE_CXX_COMPILER=g++ .. - 注意：这个错误和
CMakeLists.txt内容无关，不用急着改脚本
add_executable() 为什么总提示“source file not found”
根本原因是 add_executable() 的第二个及后续参数必须是相对于 CMakeLists.txt 所在目录的**真实路径**，不是 glob 模式，也不自动递归。
- 错误写法：
add_executable(myapp *.cpp)→ CMake 不展开通配符 - 错误写法：
add_executable(myapp src/main.cpp)但实际文件在./main.cpp→ 路径不匹配 - 正确做法：把源文件和
CMakeLists.txt放同一目录，或用${CMAKE_CURRENT_SOURCE_DIR}显式拼接，例如：add_executable(myapp ${CMAKE_CURRENT_SOURCE_DIR}/src/main.cpp) - 小技巧：用
message(STATUS "SOURCES: ${SOURCES}")打印变量值，验证路径是否如你所想
cmake --build . 提示“No rule to make target”
说明生成阶段（cmake ..）看似成功，但实际没产出有效的构建目标，常见于 project() 和 add_executable() 之间缺了关键设置。
- 检查
project()是否声明了语言，比如project(hello LANGUAGES CXX)；没写LANGUAGES时，CMake 可能默认只启用 C，导致.cpp文件被忽略 - 确认
add_executable()的第一个参数（目标名）是合法标识符：不能含/、空格、点号，比如add_executable(my.app main.cpp)会失败 - Linux/macOS 下构建后可执行文件默认生成在当前构建目录（如
build/），不是源码目录，别在源码目录里找./myapp - Windows + MSVC 时，
cmake --build .默认调用msbuild，若没装 VS 或 Build Tools，会静默失败——此时换用cmake --build . --verbose看真实报错
最容易被忽略的一点：CMake 不会自动 reload CMakeLists.txt。改完脚本后，必须删掉整个构建目录（或至少删掉 CMakeCache.txt 和 CMakeFiles/）再重新运行 cmake ..，否则旧缓存可能掩盖新问题。
