windows安装cmake时未勾选“add cmake to the system path”会导致命令不可用；linux apt安装版本常过旧（如3.16），需手动下载二进制包并配置path；macos需先安装xcode命令行工具，再通过homebrew安装；所有平台均须验证cmake、编译器及构建工具三者版本可用。
cmake 安装本身不难，但装完找不到命令、版本太旧、或跨平台行为不一致，才是真问题。直接上手就行，别被“完整教程”四个字吓住。
Windows 上装完 cmake 却提示“不是内部或外部命令”
这是最常见也最烦人的坑——安装时没勾对选项。
- 下载官方
.msi包（不是.zip），运行后务必勾选 Add CMake to the system PATH for all users（推荐）或 for current user - 装完必须新开一个 CMD 或 PowerShell 窗口，旧窗口的环境变量不会自动刷新
- 如果已装过但漏勾了，别重装：手动把
C:\Program Files\CMake\bin（或你自定义的安装路径下的bin目录）加到系统PATH里 - 验证用
cmake --version，不是cmake -version（少个短横会报错）
Linux 用 apt install cmake 装出来版本太老
Ubuntu/Debian 默认源里的 cmake 经常卡在 3.10–3.16，而很多新项目要求 3.20+，find_package 或 FetchContent 会直接失败。
- 先检查现状：
cmake --version，低于 3.20 就别硬扛 - 优先用二进制包（比源码编译快得多）：去 cmake.org/download 下载
cmake-X.Y.Z-linux-x86_64.tar.gz - 解压后把
cmake-X.Y.Z-linux-x86_64/bin加到$PATH（写进~/.bashrc或~/.zshrc），然后source一下 - 不用删系统自带的，新路径往前放就行；
which cmake能确认实际调用的是哪个
macOS 上用 Homebrew 装 cmake 后找不到编译器
cmake 本身装好了，但执行 cmake -S . -B build 时报错说找不到 clang 或 gcc，其实是 Xcode 命令行工具没装全。
- 先跑
xcode-select --install，弹窗点安装（不是只装 Xcode App） - 再确认
clang --version和gcc --version都能输出，否则cmake生成构建文件时会跳过编译器检测 - Homebrew 安装命令就是
brew install cmake，装完不用额外配置PATH（Homebrew 自动处理） - 如果用 M1/M2 Mac，注意某些旧版
cmake二进制包不支持 ARM64，优先选 Homebrew 或官网带universal标签的版本
cmake --version 成功但 cmake -S . -B build 报错找不到 CMakeLists.txt
这不是安装问题，是路径或项目结构没理清。新手常以为只要装了就能跑，其实 cmake 是严格依赖项目根目录下存在 CMakeLists.txt 的。
- 确保你在项目根目录（即有
CMakeLists.txt的那个文件夹）执行命令 -
-S .表示源码目录是当前目录，-B build表示构建目录叫build；不能写成cmake build（那是老式写法，且容易误入子目录） -
CMakeLists.txt至少得有两行：cmake_minimum_required(VERSION 3.10)和project(MyApp)，缺一不可 - 文件名必须全大写、无扩展名，写成
CMakeLists.txt.txt或cmakelists.txt都不行
cmake 最容易被忽略的，不是下载或点击下一步，而是它根本不管你的编译器和构建工具链有没有就位。装完第一件事不是跑项目，而是确认 cmake --version、gcc --version（或 clang --version）、make --version（或 ninja --version）三个命令都能回显——少一个，后面都可能卡在莫名其妙的地方。
