先确认CMAKE_C_COMPILER是否真能被找到：该错误源于PATH中缺失gcc、cl.exe或clang路径，非CMake故障；Windows需检查VS“使用C++的桌面开发”工作负载是否安装，Linux/macOS则排查build-essential或Xcode命令行工具是否就绪。
报错说“找不到编译器”：先确认CMAKE_C_COMPILER是否真能被找到
这个错误不是CMake坏了，而是它压根没在PATH里看到gcc、cl.exe或clang。Windows上常见于只装了VS但没装“使用C++的桌面开发”工作负载；Linux/macOS则多因没装build-essential或Xcode command line tools。
- Windows：运行
vswhere.exe -latest -products * -format json，检查输出中installationPath是否存在且含VC\Tools\MSVC子目录 - Linux：执行
which gcc和gcc --version，若失败就装sudo apt install build-essential - macOS：运行
xcode-select --install，再确认clang --version可执行 - 别手动改
CMAKE_C_COMPILER变量——除非你明确知道路径且版本兼容，否则极易引发后续链接不匹配
Generator报错“找不到Visual Studio实例”：不是没装，是CMake看不见
CMake不靠开始菜单找VS，它依赖vswhere.exe扫描注册表和磁盘路径。即使VS图标在桌面上，CMake仍可能返回空结果。
- 检查
vswhere.exe是否在${env:ProgramFiles(x86)}\Microsoft Visual Studio\Installer\下存在 - 运行
vswhere -all -prerelease，确认输出包含你期望的版本（如2022 Community），且installationPath目录真实存在 - 如果用
-G "Visual Studio 17 2022"但vswhere只返回16.x，说明CMake版本太旧——需升级到3.21+才原生支持VS2022 - 避免在命令行中混用
-A x64和-T host=x64，二者冲突时CMake会静默忽略其中一个，导致生成器失败
find_package报错“Could NOT find XXX”：不是库没装，是CMake不会找
find_package(OpenCV REQUIRED)失败，大概率不是OpenCV没装，而是它没放在CMake默认搜索路径里，或者Config文件名/结构不匹配。
- Linux上apt装的库通常把
*Config.cmake放在/usr/lib/x86_64-linux-gnu/cmake/，而源码安装默认放/usr/local/lib/cmake/——用cmake -D CMAKE_PREFIX_PATH=/usr/local可补救 - 手动指定路径更可靠：
cmake -D OpenCV_DIR=/opt/opencv/lib/cmake/opencv4 ..，注意路径末尾不要带OpenCVConfig.cmake文件名 - 查证库是否真有Config模式支持：进
lib/cmake/目录看有没有xxx-config.cmake或XXXConfig.cmake，没有就只能走Module模式（需把FindXXX.cmake放进CMAKE_MODULE_PATH） - 别信“我明明
sudo make install了”，有些库（如Glog）默认不安装Config文件，得加-DBUILD_SHARED_LIBS=ON -DCMAKE_INSTALL_PREFIX=/usr/local重编
CMakeCache.txt改完还是错：缓存不是配置记录，是过期快照
CMakeCache.txt不是人类友好的配置文件，它是CMake上次运行时对环境的一次快照。手动编辑后，CMake不会重新检测，只会拿旧值硬套新环境，结果往往更糟。
- 清理必须彻底：
rm -rf CMakeFiles/ CMakeCache.txt cmake_install.cmake Makefile，只删CMakeCache.txt不够——CMakeFiles/里存着已缓存的编译器特征检测结果 - 跨平台切换（比如从MSVC切到MinGW）后，必须清缓存，否则CMake会尝试用MSVC的
cl.exe参数调用gcc - 升级CMake或VS后也得清，新版本可能新增检测项，旧缓存里根本没有对应字段，导致逻辑跳过关键步骤
- 真要调试，用
cmake -DCMAKE_VERBOSE_MAKEFILE=ON ..看实际调用的编译命令，比盯着Cache文件猜靠谱得多
最常被跳过的其实是环境变量刷新——改完PATH或装完组件后，新开终端再跑CMake，而不是在同一个shell里反复试。CMake启动时读一次环境，之后就再也不看了。
