cmake_c_compiler not set错误源于cmake未检测到可用编译器。需先确认visual studio（用x64命令提示符）或mingw（检查gcc/g++是否在path并能运行），再显式指定编译器路径或清理cmakecache.txt重配置。
找不到编译器：CMAKE_C_COMPILER not set
这是 Windows 上最常卡住的第一步，尤其用 VS Code 或命令行直接跑 cmake .. 时。根本不是你代码有问题，而是 CMake 根本没看到编译器。
先确认编译器是否真在系统里：
- Windows 装了 Visual Studio？打开“x64 Native Tools Command Prompt”，再运行
cmake ..—— 不要直接在普通 cmd 或 PowerShell 里试 - 用 MinGW-w64？运行
gcc --version和g++ --version，如果报“不是内部或外部命令”，说明mingw64\bin没加进PATH - Linux/macOS？
which gcc和which g++必须有输出；没输出就装：sudo apt install build-essential（Ubuntu）或xcode-select --install（macOS）
别依赖 CMake 自动猜——显式指定更稳：
cmake -DCMAKE_C_COMPILER=gcc -DCMAKE_CXX_COMPILER=g++ ..
或者在 CMakeLists.txt 开头加：
set(CMAKE_C_COMPILER "gcc" CACHE FILEPATH "") set(CMAKE_CXX_COMPILER "g++" CACHE FILEPATH "")
CMakeCache.txt 路径不一致导致配置失败
复制/重命名项目文件夹后立刻用 VS Code 打开，十有八九会报错“project files may be invalid”。罪魁祸首就是 CMakeCache.txt 里硬编码的旧路径。
比如缓存里记着 S:/stm32/vs_1/，但你现在打开的是 S:/stm32/vs_1_free/，CMake 直接拒绝继续。
解决方法极简：
- 关掉 VS Code
- 进项目根目录，删掉整个
build/文件夹（或至少删掉build/CMakeCache.txt） - 重启 VS Code，重新触发 CMake 配置
别试图手动改 CMakeCache.txt —— 它是自动生成的二进制风格文本，改错一个字符就全废。VS Code 插件里按 Ctrl+Shift+P → CMake: Delete Cache and Reconfigure 也等效。
find_package 找不到库（如 OpenCV、Ceres）
错误信息像这样：
CMake Error at CMakeLists.txt:15 (find_package):
Could not find a package configuration file provided by "OpenCV" with any
of the following names:
OpenCVConfig.cmake
opencv-config.cmake
这不是库没装，而是 CMake 不知道去哪翻。常见原因：
-
OpenCV_DIR没设，而 OpenCV 是手动编译安装的（非系统包管理器装的） - 装了 OpenCV 4.x，但
find_package(OpenCV 3.4)硬指定旧版本，版本不匹配 - ROS 环境下混用
catkin_make和catkin build，缓存残留干扰查找路径
快速定位：
cmake --find-package -DNAME=OpenCV -DMODE=EXIST
如果返回空，说明 CMake 根本没扫描到安装位置。临时救急写法：
set(OpenCV_DIR "/usr/local/lib/cmake/opencv4") # Linux 示例 find_package(OpenCV REQUIRED)
注意路径必须精确到 lib/cmake/opencv4/ 这一级，不是 lib/ 或 share/。
CMAKE_ROOT 找不到：升级 CMake 后命令能运行但报错
执行 cmake --version 显示新版本号，却弹出 Could not find CMAKE_ROOT —— 这说明可执行文件和配套资源目录（share/cmake-*/）不在一起。
典型场景：
- 从官网下载 zip 包解压，只把
bin/cmake.exe复制到某个目录，漏了share/整个文件夹 - 用 choco 或 scoop 升级，旧软链接还指向老版本的 bin 目录
- conda 环境激活后，PATH 优先用了 conda 自带的 cmake，但它没配好资源路径
验证当前 cmake 实际加载路径：
cmake -E echo "$CMAKE_ROOT"
如果为空或报错，就说明环境没对。最稳妥做法：卸载所有版本，从 cmake.org 下完整安装包，选“Add CMake to the system PATH”选项。别图省事只拷二进制。
