1、CMake 版本不匹配
错误描述：使用的 CMake 版本与项目文件要求的不一致，可能导致一些特性无法识别或语法不兼容，较新的 CMakeLists.txt 文件中使用了新版本的 CMake 功能，但安装的 CMake 版本过低。
解决方法：查看项目文档或项目根目录下的 CMakeLists.txt 文件，了解项目所要求的 CMake 最低版本，然后到 CMake 官方网站下载并安装相应版本的 CMake。
2、环境变量配置错误
错误描述：CMake 在配置过程中需要依赖一些环境变量来查找编译器、库文件等，如果这些环境变量没有正确设置，就会导致配置失败，在 Linux 系统中，如果没有正确设置 CC（C 编译器）和 CXX（C++ 编译器）环境变量，CMake 可能无法找到合适的编译器。
解决方法：检查系统的环境变量设置，在 Linux 中，可以通过查看 ~/.bashrc、~/.bash_profile 等文件来确认环境变量是否正确配置，如果在 Windows 中，可以通过“系统属性”>“高级”>“环境变量”来查看和设置环境变量，确保 CC 和 CXX 等变量指向正确的编译器路径。
3、缺少依赖库或头文件
错误描述：项目依赖于某些外部库或头文件，但在配置时无法找到它们，这可能是因为这些库没有安装，或者安装位置没有被包含在 CMake 的搜索路径中。
解决方法：仔细阅读项目文档，确定项目所需的所有依赖库及其安装方法，对于常见的库，如 OpenCV、Boost 等，可以在官方网站上找到相应的安装教程，安装完依赖库后，CMake 仍然找不到，可以尝试手动指定库的路径，在 CMakeLists.txt 文件中使用 find_package() 函数时，可以添加 PATHS 参数来指定搜索路径。
4、语法错误
错误描述：CMakeLists.txt 文件中存在语法错误，如命令拼写错误、括号不匹配、变量未定义等。
解决方法：仔细检查 CMakeLists.txt 文件的语法，根据错误提示信息定位问题所在，可以参考 CMake 官方文档中的语法说明进行修正，如果错误提示比较模糊，可以尝试在命令行中使用cmake .. 命令并重定向输出到文件，以便更详细地查看错误信息。
以下是两个关于 CMake 报错的常见问题及解答：
1、问题：在运行 CMake 时出现 “The C compiler identification is unknown” 错误，该如何解决？
解答：这通常是因为 CMake 无法识别系统中的 C 编译器，检查是否安装了 C 编译器，如 GCC 等，如果已安装，尝试手动指定编译器路径给 CMake，在 Linux 系统中，可以使用以下命令来指定编译器路径：
cmake DCMAKE_C_COMPILER=/path/to/gcc ..
cmake DCMAKE_C_COMPILER=gcc ..
2、问题：CMake 报 “Could not find a package configuration file provided by "OpenCV" with any of the following names: OpenCVConfig.cmake; opencv.config” 错误，怎么解决？
解答：这表示 CMake 没有找到 OpenCV 的配置文件，首先确认 OpenCV 是否正确安装，并且安装路径已被添加到系统的库搜索路径中，OpenCV 是自定义安装的，可能需要手动指定 OpenCV 的模块路径，在 CMakeLists.txt 文件中添加以下代码：
set(OpenCV_DIR /path/to/opencv)
find_package(OpenCV REQUIRED)
CMake 报错的原因可能涉及多个方面，包括版本不匹配、环境变量配置错误、缺少依赖库或头文件以及语法错误等，通过仔细检查错误信息、参考官方文档和相关资料，通常可以找到并解决问题。
