cmake --version报错“command not found”说明PATH未包含cmake路径，需确认是否安装并将其bin目录加入环境变量；若返回旧版本，则需升级至项目要求的最低版本（如3.27+），推荐官网二进制安装并配置PATH。
CMake 报错不一定是 CMake 写错了，大概率是环境没配对、版本不匹配、或命令被误触发。
cmake --version 返回旧版本或 command not found
这是最常被跳过的前置检查。Ubuntu 22.04 自带 cmake 3.22，但很多新项目要求 cmake_minimum_required(VERSION 3.27)；Debian 12 是 3.25，Fedora 39 是 3.26 —— 都不够用。
- 别信
which cmake，它只告诉你路径，不告诉你版本；必须跑cmake --version - 如果返回
command not found，说明根本没装，或者 PATH 没生效（比如装到$HOME/cmake/bin但没加进~/.bashrc） - 如果多个版本共存，用
type -a cmake查清顺序，再用ls -l $(which cmake)看软链指向哪 - 推荐直接下官网二进制包：
wget https://github.com/Kitware/CMake/releases/download/v3.29.2/cmake-3.29.2-linux-x86_64.sh，然后./cmake-3.29.2-linux-x86_64.sh --prefix=$HOME/cmake --skip-license，最后加export PATH=$HOME/cmake/bin:$PATH到 shell 配置里
执行 cmake .. 时提示 “arm linux … command not found”
这不是 CMake 本身报错，而是 CMake 在配置阶段尝试调用交叉编译器（比如 arm-linux-gnueabi-gcc），但系统里没装或没设好 CROSS_COMPILE。
- 先确认是否真要交叉编译：如果只是编译 x86_64 本地程序，
CMakeLists.txt里不该出现set(CMAKE_SYSTEM_NAME Linux)+set(CMAKE_SYSTEM_PROCESSOR arm)这类组合 - 如果确实要交叉编译，得装对应工具链：
sudo apt install gcc-arm-linux-gnueabi（ARM32）或gcc-aarch64-linux-gnu（ARM64） - 然后导出变量：
export CROSS_COMPILE=arm-linux-gnueabi-（注意末尾短横线），再跑cmake .. - 也可以在 cmake 命令里直接指定：
cmake -DCMAKE_TOOLCHAIN_FILE=/path/to/arm-toolchain.cmake ..，避免污染全局环境
链接时报 undefined reference（比如 gzdopen、pthread_create）
CMake 不会自动链接你代码里用到的库，哪怕头文件（#include <zlib.h>）能找到，gzdopen() 的实现也得显式告诉链接器去哪找。
- 查缺失符号属于哪个库：比如
undefined reference to 'gzdopen'→ 对应z库；pthread_create→ 对应pthread - 在
CMakeLists.txt中补target_link_libraries(your_target_name z pthread)，不是find_package(ZLIB)就完事了 - 确保开发头文件已装：
sudo apt install zlib1g-dev libpthread-stubs0-dev（仅运行库zlib1g不够） - 注意顺序：
target_link_libraries必须写在add_executable或add_library之后，否则无效
执行 ls 或其他普通命令突然报 CMake Error
这基本等于“你的 ls 被替换了”，不是 CMake 问题，而是 PATH 里混进了个假 ls。
- 运行
/bin/ls看是否正常；如果正常，说明 PATH 里有别的ls - 用
type -a ls查所有匹配项，重点看/usr/local/bin/ls或~/bin/ls - 用
file $(which ls)看它是不是个 shell 脚本，里面有没有误写了cmake命令 - 临时修复：把
/bin提前到 PATH 开头，或删掉可疑的ls；长期建议用hash -d ls清缓存 +rehash
真正卡住的时候，往往不是语法写错，而是版本、路径、工具链、链接这四块里某一块没对齐。先跑 cmake --version 和 which cmake，再看报错里第一个冒号前的词——是 “CMake Error” 还是 “command not found” 还是 “undefined reference”，三者排查路径完全不同。
