cmake命令找不到的根本原因是PATH环境变量未包含其安装路径。需先用which cmake或echo $PATH确认是否在搜索路径中，再根据安装方式（如官网.sh包默认装至/opt/cmake/bin）将对应bin目录添加到PATH，并确保文件有执行权限。
cmake命令找不到？先确认PATH和权限
装完 cmake 却提示 command not found，大概率是 PATH 没生效或安装路径不在默认搜索范围。CentOS/RHEL 用 yum install cmake、Ubuntu/Debian 用 apt install cmake 一般会装到 /usr/bin/cmake，直接可用；但若从官网下载 .sh 安装包手动安装，默认路径是 /opt/cmake/bin/cmake，得自己加进 PATH。
检查方法：which cmake 或 type cmake。如果为空，临时补上：export PATH="/opt/cmake/bin:$PATH"（替换为你实际的安装路径）；要永久生效，把这行加到 ~/.bashrc 或 /etc/profile 里，再 source 一下。
另外注意权限：手动安装后若提示 Permission denied，可能是 cmake 文件没执行权限，运行 chmod +x /opt/cmake/bin/cmake 即可。
CMakeLists.txt写错最常见的三个地方
刚写完 CMakeLists.txt 就报错？不是语法太复杂，而是几个硬性规则容易被忽略：
-
cmake_minimum_required(VERSION 3.10)必须是文件第一行，且版本号不能写成3.10.0或带空格——只认MAJOR.MINOR格式 -
project()要紧跟其后，名字不能含空格或特殊字符（比如my-project会触发警告，my project直接失败） -
add_executable()的源文件路径必须存在且拼写完全一致——main.cpp和main.CPP在 Linux 下是两个文件，CMake 不自动纠错
建议写完立刻用 cmake -S . -B build 测试解析（不生成构建文件），比直接 cmake . 更早暴露问题。
为什么推荐 out-of-source 构建？
直接在源码目录下跑 cmake . 看似省事，但会导致根目录塞满 CMakeFiles/、CMakeCache.txt、Makefile 等中间文件，git 提交易误提交、清理麻烦、多构建配置（Debug/Release）无法共存。
正确做法是新建独立构建目录：
mkdir build && cd build-
cmake ..（从构建目录指向源码目录） - 后续所有
make、make install都在build/下执行
这样源码目录干净，还能同时开多个构建目录，比如 build-debug、build-release，互不干扰。CMake 3.13+ 支持 -S 和 -B 参数一步到位：cmake -S . -B build。
make 编译失败但 CMake 没报错？重点查这几处
cmake .. 成功只代表配置通过，不代表能编译成功。常见真·编译失败点：
- 头文件路径没加对：
include_directories()或target_include_directories()指向了不存在的目录，或路径写成相对build/而非source/ - 链接库名写错：
target_link_libraries(myapp PRIVATE pthread)是对的，但写成libpthread.so或pthread.so就会失败——CMake 要的是逻辑名，不是文件名 - C++ 标准不匹配：源码用了
auto或std::optional，但set(CMAKE_CXX_STANDARD 11)设太低，得改成17或20
调试时加 make VERBOSE=1，看真实调用的 g++ 命令行，一眼就能发现缺了 -I 还是漏了 -l。
真正麻烦的从来不是 CMake 本身，而是它把“配置”和“编译”两层错误混在一起报——你得先分清是 CMake 解析阶段挂了，还是 make 执行阶段挂了。前者看 cmake 输出，后者盯 make 日志，别一上来就重写整个 CMakeLists.txt。
