CMake无法读取自身内置变量？OpenCV依赖配置问题排查

1. OpenCVModules.cmake文件存在生成缺陷 #

你遇到的核心矛盾在于项目根CMakeLists里能正常读取CMAKE_VERSION，但OpenCV模块文件里却读不到——这大概率是因为你使用的OpenCV预编译包（或自行编译的OpenCV）在生成OpenCVModules.cmake时存在逻辑漏洞：

• 该文件的版本检查代码可能错误依赖局部作用域变量，而非CMake全局内置变量；
• 或是生成该文件的OpenCV构建脚本存在bug，没有正确将全局CMake变量传递到模块文件中，导致外部项目调用时，CMAKE_VERSION等内置变量在模块上下文里无法被读取。

2. 误加载了旧版本OpenCV的模块文件 #

尽管你指定了find_package(OpenCV 4)，但如果系统CMake模块搜索路径中存在旧版本（比如2.x）的OpenCV配置文件，可能出现以下情况：

• 旧版本的OpenCVModules.cmake被优先加载，其版本检查逻辑要求CMake >=2.8.3，但由于旧文件写法问题，无法正确读取当前项目的CMAKE_VERSION，从而抛出变量为空引发的错误；
• 即便指定了版本4，CMake的版本匹配逻辑可能因搜索路径优先级问题，误匹配到不符合版本要求的旧模块文件。

3. CMake变量作用域被意外干扰 #

如果项目在调用find_package(OpenCV)之前存在以下操作，可能导致内置变量在模块加载时失效：

• 在自定义function()或macro()内部执行find_package：CMake函数拥有独立作用域，虽然CMAKE_VERSION是全局变量，但如果函数内部存在错误的变量覆盖（比如意外执行set(CMAKE_VERSION "")），会导致模块加载时读取到空值；
• 项目中存在修改CMake全局变量的不当操作，比如重载了CMAKE_VERSION相关内置变量的默认行为。

4. OpenCV构建环境与当前项目环境不兼容 #

如果你是自行编译的OpenCV，可能存在：

• 编译OpenCV时使用的CMake版本过低，其生成的OpenCVModules.cmake不兼容当前项目使用的CMake 3.16版本，导致变量读取逻辑失效；
• 编译OpenCV时的配置参数有误，比如禁用了某些CMake变量传递的功能，导致模块文件无法正确获取当前项目的CMake版本信息。

内容的提问来源于stack exchange，提问作者Nolan