cmake_root 找不到是因 cmake 启动后无法定位 share/cmake- 目录；idf_path 未设或含空格/中文导致 include 失败；no cmake_c_compiler 是因 shell 环境未正确暴露编译器路径；多工具共存时 cmake_prefix_path 混乱会引发模块查找失败。
CMAKE_ROOT 找不到，说明 CMake 运行时根本没定位到自己的安装目录
这个错误不是“CMake 没装好”，而是它启动后在内部找不到 share/cmake-<version></version> 这个关键资源目录。常见现象是执行 cmake --version 就直接报 Could not find CMAKE_ROOT，而不是版本号输出。
先确认你实际调用的是哪个 cmake：
which cmake
如果返回的是 /usr/local/bin/cmake，但新版本装在 /opt/cmake-3.28，那问题就清楚了——PATH 指向了一个“残缺”的旧链接或二进制文件。
- 检查该路径下是否存在
share/cmake-<version></version>目录（比如/usr/local/share/cmake-3.28） - 若不存在，别硬改环境变量，直接删掉
/usr/local/bin/cmake和可能存在的同名软链接 - 把新安装目录的
bin加进 PATH，例如：export PATH="/opt/cmake-3.28/bin:$PATH" - 务必重新打开终端或运行
source ~/.bashrc（或对应 shell 配置文件）
IDF_PATH 未设置或路径错误，导致 ESP-IDF 项目 include($ENV{IDF_PATH}/tools/cmake/project.cmake) 失败
这不是 CMake 自身的问题，而是构建系统依赖的环境变量缺失。错误典型表现为：
CMake 4.3.2 Windows x86_64 历史版本安装包，适合旧项目兼容、构建环境回退、CMakeLists.txt 迁移验证、Visual Studio/Ninja/Makefile 生成器测试和 C/C++ 项目维护。
CMake Error at CMakeLists.txt:10 (include):
include could not find requested file:
${env:IDF_PATH}/tools/cmake/project.cmake
注意：这里报的是 ${env:IDF_PATH}，不是 $ENV{IDF_PATH} —— 说明你可能误用了 CMake 的 env: 语法（那是 VS Code 或某些插件的写法），而 CMake 正确写法是 $ENV{IDF_PATH}。
- 先在终端里运行
echo $IDF_PATH，确认变量是否已导出且路径真实存在 - 路径中不能含空格或中文，比如
C:\Espressif\esp-idf可以，C:\Program Files\esp-idf会失败 - Linux/macOS 下建议用
export IDF_PATH=/opt/esp-idf，然后加到~/.bashrc；Windows 下必须设为系统级环境变量（不只是当前 CMD） - 临时验证可直接在
CMakeLists.txt中写死路径：include(/opt/esp-idf/tools/cmake/project.cmake)，能过就说明纯属环境变量问题
No CMAKE_C_COMPILER could be found，CMake 找不到 cl.exe 或 gcc
这个报错和编译器本身是否安装无关，只和 CMake 是否能在当前 shell 环境里“看见”它有关。即使你把 Visual Studio 的 VC\bin 加进了 PATH，CMake 仍可能找不到 cl.exe。
- 先手动查：
where cl.exe（Windows）或which gcc（Linux/macOS），确保命令能返回路径 - 如果返回为空，说明 PATH 没生效，或你加的路径不对（VS2022 的
cl.exe实际在VC\Tools\MSVC\<ver>\bin\Hostx64\x64\</ver>） - 不要依赖 IDE 自动探测——VS Code 的 CMake Tools 插件有时会缓存旧 Kit，按
Ctrl+Shift+P→CMake: Select a Kit重新选一次 - 最稳的办法是显式传参：
cmake -DCMAKE_C_COMPILER="C:/path/to/cl.exe" -G "Visual Studio 17 2022" ..
多版本共存时 CMAKE_PREFIX_PATH 和 AMENT_PREFIX_PATH 冲突
ROS2、Qt、Conda 等工具都会往 CMAKE_PREFIX_PATH 里塞路径，一旦顺序错乱或混入无效路径，CMake 就会在错误位置找 ament_cmake 或 FindXXX.cmake 模块。
- 运行
echo $CMAKE_PREFIX_PATH，看输出是否包含多个不相关的路径（比如同时有/opt/ros/humble和/home/user/miniconda3） - 不要全局 export 这个变量；ROS2 应该只在 source
/opt/ros/humble/setup.bash后生效，且仅限当前终端 - 如果用 colcon 构建，确保没在 ROS2 环境外执行
colcon build；错误做法是先source /opt/ros/humble/setup.bash，再source ~/my_ws/install/setup.bash，后者会覆盖前者 - 临时清空干扰：
CMAKE_PREFIX_PATH="" colcon build，看是否还报错，能过就说明是路径污染
真正容易被忽略的是：CMake 在解析环境变量时不做容错，一个路径权限不对、少一个斜杠、甚至末尾多了个空格，都可能导致整个查找链中断。别急着改配置，先用 echo 和 ls 把每个变量值和对应路径的存在性、可读性逐层验证一遍。
