简介面向Windows 64位开发者的CMake 3.14.2官方发行版用于在跨平台场景下统一管理构建过程生成Visual Studio解决方案或makefile。该版本对OpenCV这类依赖较多第三方库的项目尤其友好可在CMakeLists.txt中集中指定头文件、库路径与编译选项。压缩包约29.58MB共5681个文件主要包含cmake配置脚本、rst/html/txt格式的详细文档、cmake-gui与cmake等可执行程序以及ctest、cpack等测试打包工具另附大量示例与模块头文件以及cmake、ctest等命令的man手册便于离线查阅。目前已有171人学习。无论是刚接触构建系统的初学者还是需要为OpenCV二次开发配置环境的工程师都能借助包内文档和示例快速掌握跨平台构建方法减少手工配置带来的时间损耗。1. 从下载到编译CMake 3.14.2 win64-x64 为什么是你搭建 OpenCV 环境最省事的起点如果你准备在 Windows 64 位机器上用 OpenCV 做图像处理第一个卡住你的不是 opencv 源码而是 cmake3 这套构建系统——下载源码、依赖配置、生成 Visual Studio 工程全要它来管。CMake 3.14.2 win64-x64 是 2019 年的稳定版本放在今天仍然能正常驱动 OpenCV 3.4.x 和 4.x 的 Release 分支而且它对 Visual Studio 2017/2019 的支持很成熟不像新版本那样偶尔冒出编辑器兼容性报错。这篇文章适合两类人一类是刚学 OpenCV 的新手装完安装包发现 cmake 命令不识别或者 GUI 一度卡在 Configure 亮红色另一类是熟手想给团队留一个可复现的构建脚本省得每次换机器都从零折腾。接下来我会按安装、配置、构建、排坑的顺序讲末尾给你一个能直接抄的 bat 脚本。2. 安装与环境配置三个关键点让 CMake 3.14.2 在 Windows 上真正可用2.1 选对安装包win64-x64 与 win32-x86 的取舍下载 CMake 3.14.2 时发行页面会给出多个压缩包网上很多人直接点第一个结果装完发现根本生成不了 64 位工程。win64-x64 表示该安装包内置的是 64 位原生支持它内部的 CMake 程序是 x64 架构生成 Visual Studio 工程时能识别-A x64或Win64平台参数。而 win32-x86 是 32 位程序虽然也能在 64 位系统上运行但某些钩子脚本、Find 模块在搜索 64 位库时会走错路径导致你后面用 OpenCV 时链接到的静态库架构对不上。我一般会先确认系统位数win10/win11 基本都是 x64。然后右键“此电脑”属性确认一下再下载cmake-3.14.2-win64-x64这个包。不要图省事用 zip 便携版安装版会自动处理注册表关联方便后续让 IDE 识别。2.2 安装步骤与 PATH 变量设置避开 C 盘权限和“命令行找不到 cmake”安装过程有三个坑我会一个个拆开说。第一安装路径不要选C:\Program Files\CMake这种带空格的目录。虽然 CMake 自己处理过空格但后续你把路径写进批处理脚本时转义会平白多出一堆反斜杠更麻烦的是某些旧版 Find 模块拼接路径时不带引号导致 OpenCV 的生成步骤掉链子。我每次装都会手动改成C:\Tools\CMake314当然这是个人习惯不强求。第二安装向导走到“Install Options”那一步时务必勾选 “Add CMake to the system PATH for all users”。这一步决定了你在命令提示符里敲cmake能不能直接被找到。如果漏选了后期还得手动去系统环境变量里加。加的时候注意只加 bin 目录比如C:\Tools\CMake314\bin不要整个 CMake 根目录加进去否则系统会去根目录找cmake.exe找不到。第三如果遇到“没有权限写入 PATH”类似提示多半是当前账户不是管理员或系统环境变量被策略锁住。这种时候我不会和它硬刚直接改用用户环境变量把 CMake 的 bin 目录加到用户 PATH 里也能生效只是当前用户有效。反正你开发时用哪个账号就加哪个。加完必须新开一个控制台窗口让环境变量重新加载否则cmake --version依然报“不是内部或外部命令”。2.3 命令行验证与图形界面初探装完先不要急着开 GUI先在新开的 CMD 里敲cmake --version正常的输出应该包含cmake version 3.14.2。紧接着敲cmake-gui如果窗口能弹出来说明安装没问题。这个时候你可以顺手测一下 Visual Studio 生成器是否被识别执行cmake --help输出列表里找Visual Studio 15 2017或Visual Studio 16 2019这样的字符串只要存在就说明 CMake 能找到对应版本的 VS 实例。如果列表为空或者只有 MinGW Makefiles说明你的 VS 安装位置有问题或者 CMake 没找到注册表键值——这个在后面的避坑章节会专门讲。3. 用 CMake 3.14.2 构建 OpenCV 项目从源码到 Visual Studio 解决方案的完整流程3.1 为什么选 CMake 3.14.2 而不是最新版稳定性和生态兼容性的现实考量很多教程会直接让你装最新版 CMake但在 OpenCV 构建场景下最新版不一定比老版本更可靠。CMake 3.14 是生成器表达式和 Find 模块体系相对稳定的一个节点OpenCV 3.4.9 和 4.1.0 的官方 Release 说明里明确测试过它。我见过有人用 CMake 3.20 配置 OpenCV结果在find_package(OpenCV)阶段出现Config.cmake路径变量类型变化导致生成的工程里链接命令多出一串强制的属性编译报 warning 当成 error。而 3.14.2 不会搞这些幺蛾子。另外VS 2019 的 C 工具集在 CMake 3.14 的兼容表里是被正式支持的所以用 3.14.2 生成出来的.sln工程打开后不会要求你强制转换。如果你团队里既有 VS2017 又有 VS20193.14.2 生成的工程两边都能打开这是老版本的一个隐形福利。3.2 准备 OpenCV 源码与依赖项清单构建 OpenCV 前先列一张依赖清单不然 Configure 会反复报缺模块。以 OpenCV 4.x 为例最基础的需要OpenCV 主库源码source和解压后的 opencv_contrib 扩展模块目录都放到同一个父文件夹下。Python 3.x 和 numpy用于生成 OpenCV-Python 绑定如果不打算用 Python 接口可以关闭BUILD_opencv_python3能省很多编译时间。可选的 CMake 依赖是 Eigen、TBB、OpenEXR 等这些不装也能出包只是某些算法模块性能会打折。下面这个表是我常用的最小依赖集合非必要的我都不勾先把核心库编出来依赖项是否必需我一般装不装备注Python 3.x否装但要指定路径不装就关 python 绑定numpy否装没有 numpy 会导致 python 绑定生成不了TBB否不装开 WITH_TBB 需要单独下库Eigen否装增强姿态估计等模块性能可选项OpenEXR否不装处理 HDR 图像才需要Qt否不装如果不开发 GUI用默认 HighGUI 就够3.3 CMake GUI 配置从 Configure 到 Generate 一共要改动哪些参数打开 CMake GUI第一行填 OpenCV 源码目录也就是包含CMakeLists.txt的那个文件夹第二行填构建目录我会在源码旁边新建一个build-vs2019-x64文件夹注意构建目录永远不能在源码目录里否则后面增量编译会触发“源目录不干净”的报错。点 Configure第一次会让你选生成器这里直接选Visual Studio 16 2019右侧平台选x64。如果机器里装的是 VS2017就选Visual Studio 15 2017加x64。选错生成器是头号翻车点后面我会专门写。Configure 跑完后重点关注这些变量CMAKE_BUILD_TYPERelease 版填ReleaseDebug 版填Debug。这个变量会影响NOMINMAX的宏定义如果后续在自己项目里出现min/max与 std 冲突多半就是这里没设成多配置模式。BUILD_SHARED_LIBS我习惯勾选生成 DLL 方便运行时替换也避免多个静态库导致 exe 体积爆炸。如果你要发布单文件也可以取消勾选。BUILD_opencv_world勾上后所有模块合并成一个 opencv_world 库后续链接只需要opencv_world4100.lib省事很多。OPENCV_EXTRA_MODULES_PATH填 opencv_contrib 模块的modules目路径不填就只编译主库里的标准模块。WITH_OPENGL和WITH_QT没有强需求就不开开了反而需要额外下载 OpenGL 依赖或 Qt SDK。BUILD_opencv_python3如果你确定不要 Python 绑定取消它可以少编小半天。改完这些再点一次 Configure红色变量全部变白后点 Generate最后点 Open 直接打开 VS 工程。如果你不想点鼠标见下一小节。3.4 命令行生成方式用一行命令交出一致的构建配置GUI 适合新手但换机器时还是要重新点一遍很烦。推荐在拿到源码后直接用命令行生成把配置固化到 bat 脚本里。以 VS2019 x64 为例我的生成命令是这样cmake -S D:\opencv\opencv-4.1.0 -B D:\opencv\build-vs2019-x64 -G Visual Studio 16 2019 -A x64 -DCMAKE_BUILD_TYPERelease -DBUILD_SHARED_LIBSON -DBUILD_opencv_worldON -DOPENCV_EXTRA_MODULES_PATHD:\opencv\opencv_contrib-4.1.0\modules -DBUILD_opencv_python3ON-S指定源码根目录-B指定构建目录如果目录不存在 CMake 会自动创建。-G后面必须跟生成器名称要用Visual Studio 16 2019这种带引号的完整名不能只写Visual Studio。-A指定平台架构x64是必须的否则默认生成 Win32 工程后面 OpenCV 的 x64 库一个都链接不上。-D是缓存变量开关优先级比 GUI 里改的高。注意BUILD_opencv_python3要不要开取决于你有没有对应 Python 的 Debug 版本库。如果你机器的 Python 是官网安装的那没问题如果是 Windows Store 里面的精简版CMake 经常找不到python3_d.lib这种情况下我劝你直接关掉这个选项避免 Configure 卡很久。生成完成后构建目录里会出现OpenCV.sln后面你既可以用 VS 打开编译也可以用命令行继续构建cmake --build D:\opencv\build-vs2019-x64 --config Release --target ALL_BUILD -j 8--build后面的路径就是构建目录--config Release告诉 MSBuild 编译 Release 配置-j 8限制并行编译任务数防止内存不够导致 OOM。这条命令跑完OpenCV 的 install 目录里就会产出opencv_world4100.dll和对应的.lib文件接下来就能拿这些去自己项目里做find_package了。4. 避坑排查Windows 下 CMake 加 OpenCV 的 5 个经典坑每个都能让你白忙一晚上4.1 Configure 报错The source directory is not empty 或源码被污染现象CMake 第一次 Configure 就红字提示The source directory D:/opencv/opencv does not appear to contain CMakeLists.txt.或者The source directory is not empty。原因多数是把源码跟构建目录混在一起或者解压源码时把上一版的构建缓存CMakeCache.txt也带进去了还有的是因为手动编译失败后残留了CMakeFiles文件夹。解决构建目录永远新建一个干净文件夹。另外源码目录里不要出现CMakeCache.txt如果有直接删除。我会在解压 OpenCV 源码后先搜一遍CMakeCache*确保目录干净再开始配置。4.2 找不到 Python 或 OpenCV-Python 模块直接消失现象Configure 时 CMake 提示Could NOT find PythonInterp: Found unsuitable version 2.7...或者生成后lib\python3目录里没有cv2.pyd。原因Windows 上装了多个 Python 版本CMake 默认搜索注册表命中 Anaconda 的 base 环境或 Python 2.7 残留导致解释器和开发库版本不一致。新版 CMake 用了Python3模块但 3.14.2 还在用PythonInterp和PythonLibs两个变量互相独立经常一个找到 3.7、另一个找到 3.8。解决在 GUI 里手动搜索PYTHON_EXECUTABLE、PYTHON_INCLUDE_DIR、PYTHON_LIBRARY三个变量把它们指到同一个 Python 安装路径。命令行里可以直接追加-DPYTHON_EXECUTABLEC:/Python37/python.exe -DPYTHON_INCLUDE_DIRC:/Python37/include -DPYTHON_LIBRARYC:/Python37/libs/python37.lib注意用正斜杠避免反斜杠转义问题。如果还是不生成cv2.pyd干脆关掉BUILD_opencv_python3先保证 C 库能编出来后面再用 pip 安装官方 OpenCV 包也行。4.3 选的生成器和实际安装的 Visual Studio 对不上现象Configure 一直显示Generator: Visual Studio 16 2019但点击 Open 时 VS 报错说找不到工具集或者编译时提示MSB8020: The build tools for v142 cannot be found.原因CMake 的注册表探测只认 VS 的最新版本但机器上装的是 VS2017或者装了 VS2019 但 C 桌面开发组件没勾选。还有一种情况是你选了 VS2019但工程文件被旧版 VS 打开导致平台工具集被降级。解决打开“Visual Studio Installer”看“使用 C 的桌面开发”组件是否安装。然后确保 CMake 生成器和 VS 主版本严格一致VS2017 对应Visual Studio 15 2017VS2019 对应Visual Studio 16 2019。如果只有 VS2019但 CMake 列表里没有它重启一次 VS 安装器再检查。我一般重启电脑后重新打开 CMake GUI注册表读不到的问题多半就消失了。4.4 编译时内存爆掉或 fatal error C1083现象cmake --build跑一半MSBuild 报fatal error C1083: Cannot open compiler intermediate file或者直接报C1060: compiler is out of heap space。原因Windows 上 MSBuild 默认会启动尽可能多的编译进程如果你内存只有 8GOpenCV 几千个文件的会同时开 20 个 cl.exe每个吃掉 500MB很快内存见底。解决构建时强制限制并行数用/maxcpucount或-j。比如cmake --build D:\opencv\build --config Release -j 4我在 16G 内存的机器上一般限到 632G 内存才敢开到 12。另外可以临时增加虚拟内存到 16G 以上但治标不治本。如果编译到一半崩了不要重新整编直接再跑一次同样的命令MSBuild 会增量编译只补剩余文件。4.5 运行时提示找不到 opencv_world4100.dll现象编译成功生成了 exe但运行程序时弹窗The code execution cannot proceed because opencv_world4100.dll was not found.原因OpenCV 的动态库目录没有加到系统 PATHexe 运行时搜索 DLL 的路径列表里没有它。VS 调试时会自动复制依赖 DLL但如果你直接双击 exe 或在 CMD 里跑就会缺。解决把构建目录下install\x64\vc16\bin加入 PATH或者把opencv_world4100.dll复制到 exe 同级目录。我建议用 set PATH 的方式在启动脚本里临时加set PATHD:\opencv\build-vs2019-x64\install\x64\vc16\bin;%PATH%不要修改全局系统 PATH免得多个 OpenCV 版本互相打架。如果你用的静态库BUILD_SHARED_LIBSOFF则不需要这一步。5. 进阶写一个可复用的 build_opencv.bat下次直接一键构建用 GUI 点配置的第一次会花 20 分钟但第二次我绝不再手点。我会把整个构建过程固化成一个 bat 脚本里面放一个“配置变量区”每次改几行就能适配新环境。下面是一个我常用的最小脚本echo off set SRCD:\opencv\opencv-4.1.0 set CONTRIBD:\opencv\opencv_contrib-4.1.0\modules set BUILDD:\opencv\build-vs2019-x64 set GENERATORVisual Studio 16 2019 set ARCHx64 set PYTHON_EXED:\Python37\python.exe set PYTHON_INCLUDED:\Python37\include set PYTHON_LIBD:\Python37\libs\python37.lib cmake -S %SRC% -B %BUILD% -G %GENERATOR% -A %ARCH% ^ -DCMAKE_BUILD_TYPERelease ^ -DBUILD_SHARED_LIBSON ^ -DBUILD_opencv_worldON ^ -DOPENCV_EXTRA_MODULES_PATH%CONTRIB% ^ -DPYTHON_EXECUTABLE%PYTHON_EXE% ^ -DPYTHON_INCLUDE_DIR%PYTHON_INCLUDE% ^ -DPYTHON_LIBRARY%PYTHON_LIB% ^ -DBUILD_opencv_python3ON cmake --build %BUILD% --config Release -j 8这个脚本的关键点是^续行符它告诉 CMD 下一条命令还是同一行。注意-G后面带空格的生成器名称一定要用双引号包住而%GENERATOR%变量本身已经包含空格所以脚本里我用了%GENERATOR%相当于 CMake 接收到的参数是-G Visual Studio 16 2019。如果你用的变量路径里有空格比如C:\Program Files\...则每次-D后面也要用引号包住变量值否则 CMake 会把它拆成多个参数。如果你不需要 Python 绑定把PYTHON_*三行删掉同时把-DBUILD_opencv_python3ON改成OFF或直接删除。这样 Config 阶段会少很多探测步骤失败概率下降一大截。编译时也可以只编需要的模块比如只编 core、imgproc、highgui用-DBUILD_LISTcore,imgproc,highgui能省一半时间但前提是你的代码不依赖其他模块。拿到open_world库和头文件后你自己的项目里只需要三行 CMake 就能用上find_package(OpenCV REQUIRED) include_directories(${OpenCV_INCLUDE_DIRS}) target_link_libraries(my_project PRIVATE ${OpenCV_LIBS})这里有个易踩的细节find_package(OpenCV)必须开启CMAKE_PREFIX_PATH否则 CMake 找不到安装目录。在你自己项目的 CMakeLists.txt 开头加set(CMAKE_PREFIX_PATH D:/opencv/build-vs2019-x64/install)要注意 install 目录是从哪来的。你手动编译 OpenCV 时如果不执行cmake --install则 install 目录不会生成最终find_package时OpenCV_DIR只能指向构建目录里OpenCVConfig.cmake所在的位置。因此我建议构建完成后单独跑一次安装cmake --install D:\opencv\build-vs2019-x64 --config Release --prefix D:\opencv\install--prefix可以自定义安装根目录后面你就可以把install整个拷给同事或别的机器不用再重新编译。我习惯把 install 目录整理成一个干净的 SDK 目录只保留 include、lib、bin这样即使构建目录没了我依然能链接。从那以后我每次搭 OpenCV 环境都强制走一遍这个脚本先改set SRC和set BUILD然后跑一次配置变量全部由脚本固定不会手滑漏掉-A x64或搞错 Python 路径。有一次我在新机器上直接双击脚本结果 Configure 还是报错原因是脚本里的PYTHON_LIB路径是老的 3.6新机器装的是 3.8我花了两分钟改成机器上的实际路径之后二十分钟就编译完了——比从 GUI 点起快了一个钟头。这份踏实感就是值得为 CMake 3.14.2 多花几分钟的理由希望帮到你。本文还有配套的精品资源点击获取
简介面向Windows 64位开发者的CMake 3.14.2官方发行版用于在跨平台场景下统一管理构建过程生成Visual Studio解决方案或makefile。该版本对OpenCV这类依赖较多第三方库的项目尤其友好可在CMakeLists.txt中集中指定头文件、库路径与编译选项。压缩包约29.58MB共5681个文件主要包含cmake配置脚本、rst/html/txt格式的详细文档、cmake-gui与cmake等可执行程序以及ctest、cpack等测试打包工具另附大量示例与模块头文件以及cmake、ctest等命令的man手册便于离线查阅。目前已有171人学习。无论是刚接触构建系统的初学者还是需要为OpenCV二次开发配置环境的工程师都能借助包内文档和示例快速掌握跨平台构建方法减少手工配置带来的时间损耗。1. 从下载到编译CMake 3.14.2 win64-x64 为什么是你搭建 OpenCV 环境最省事的起点如果你准备在 Windows 64 位机器上用 OpenCV 做图像处理第一个卡住你的不是 opencv 源码而是 cmake3 这套构建系统——下载源码、依赖配置、生成 Visual Studio 工程全要它来管。CMake 3.14.2 win64-x64 是 2019 年的稳定版本放在今天仍然能正常驱动 OpenCV 3.4.x 和 4.x 的 Release 分支而且它对 Visual Studio 2017/2019 的支持很成熟不像新版本那样偶尔冒出编辑器兼容性报错。这篇文章适合两类人一类是刚学 OpenCV 的新手装完安装包发现 cmake 命令不识别或者 GUI 一度卡在 Configure 亮红色另一类是熟手想给团队留一个可复现的构建脚本省得每次换机器都从零折腾。接下来我会按安装、配置、构建、排坑的顺序讲末尾给你一个能直接抄的 bat 脚本。2. 安装与环境配置三个关键点让 CMake 3.14.2 在 Windows 上真正可用2.1 选对安装包win64-x64 与 win32-x86 的取舍下载 CMake 3.14.2 时发行页面会给出多个压缩包网上很多人直接点第一个结果装完发现根本生成不了 64 位工程。win64-x64 表示该安装包内置的是 64 位原生支持它内部的 CMake 程序是 x64 架构生成 Visual Studio 工程时能识别-A x64或Win64平台参数。而 win32-x86 是 32 位程序虽然也能在 64 位系统上运行但某些钩子脚本、Find 模块在搜索 64 位库时会走错路径导致你后面用 OpenCV 时链接到的静态库架构对不上。我一般会先确认系统位数win10/win11 基本都是 x64。然后右键“此电脑”属性确认一下再下载cmake-3.14.2-win64-x64这个包。不要图省事用 zip 便携版安装版会自动处理注册表关联方便后续让 IDE 识别。2.2 安装步骤与 PATH 变量设置避开 C 盘权限和“命令行找不到 cmake”安装过程有三个坑我会一个个拆开说。第一安装路径不要选C:\Program Files\CMake这种带空格的目录。虽然 CMake 自己处理过空格但后续你把路径写进批处理脚本时转义会平白多出一堆反斜杠更麻烦的是某些旧版 Find 模块拼接路径时不带引号导致 OpenCV 的生成步骤掉链子。我每次装都会手动改成C:\Tools\CMake314当然这是个人习惯不强求。第二安装向导走到“Install Options”那一步时务必勾选 “Add CMake to the system PATH for all users”。这一步决定了你在命令提示符里敲cmake能不能直接被找到。如果漏选了后期还得手动去系统环境变量里加。加的时候注意只加 bin 目录比如C:\Tools\CMake314\bin不要整个 CMake 根目录加进去否则系统会去根目录找cmake.exe找不到。第三如果遇到“没有权限写入 PATH”类似提示多半是当前账户不是管理员或系统环境变量被策略锁住。这种时候我不会和它硬刚直接改用用户环境变量把 CMake 的 bin 目录加到用户 PATH 里也能生效只是当前用户有效。反正你开发时用哪个账号就加哪个。加完必须新开一个控制台窗口让环境变量重新加载否则cmake --version依然报“不是内部或外部命令”。2.3 命令行验证与图形界面初探装完先不要急着开 GUI先在新开的 CMD 里敲cmake --version正常的输出应该包含cmake version 3.14.2。紧接着敲cmake-gui如果窗口能弹出来说明安装没问题。这个时候你可以顺手测一下 Visual Studio 生成器是否被识别执行cmake --help输出列表里找Visual Studio 15 2017或Visual Studio 16 2019这样的字符串只要存在就说明 CMake 能找到对应版本的 VS 实例。如果列表为空或者只有 MinGW Makefiles说明你的 VS 安装位置有问题或者 CMake 没找到注册表键值——这个在后面的避坑章节会专门讲。3. 用 CMake 3.14.2 构建 OpenCV 项目从源码到 Visual Studio 解决方案的完整流程3.1 为什么选 CMake 3.14.2 而不是最新版稳定性和生态兼容性的现实考量很多教程会直接让你装最新版 CMake但在 OpenCV 构建场景下最新版不一定比老版本更可靠。CMake 3.14 是生成器表达式和 Find 模块体系相对稳定的一个节点OpenCV 3.4.9 和 4.1.0 的官方 Release 说明里明确测试过它。我见过有人用 CMake 3.20 配置 OpenCV结果在find_package(OpenCV)阶段出现Config.cmake路径变量类型变化导致生成的工程里链接命令多出一串强制的属性编译报 warning 当成 error。而 3.14.2 不会搞这些幺蛾子。另外VS 2019 的 C 工具集在 CMake 3.14 的兼容表里是被正式支持的所以用 3.14.2 生成出来的.sln工程打开后不会要求你强制转换。如果你团队里既有 VS2017 又有 VS20193.14.2 生成的工程两边都能打开这是老版本的一个隐形福利。3.2 准备 OpenCV 源码与依赖项清单构建 OpenCV 前先列一张依赖清单不然 Configure 会反复报缺模块。以 OpenCV 4.x 为例最基础的需要OpenCV 主库源码source和解压后的 opencv_contrib 扩展模块目录都放到同一个父文件夹下。Python 3.x 和 numpy用于生成 OpenCV-Python 绑定如果不打算用 Python 接口可以关闭BUILD_opencv_python3能省很多编译时间。可选的 CMake 依赖是 Eigen、TBB、OpenEXR 等这些不装也能出包只是某些算法模块性能会打折。下面这个表是我常用的最小依赖集合非必要的我都不勾先把核心库编出来依赖项是否必需我一般装不装备注Python 3.x否装但要指定路径不装就关 python 绑定numpy否装没有 numpy 会导致 python 绑定生成不了TBB否不装开 WITH_TBB 需要单独下库Eigen否装增强姿态估计等模块性能可选项OpenEXR否不装处理 HDR 图像才需要Qt否不装如果不开发 GUI用默认 HighGUI 就够3.3 CMake GUI 配置从 Configure 到 Generate 一共要改动哪些参数打开 CMake GUI第一行填 OpenCV 源码目录也就是包含CMakeLists.txt的那个文件夹第二行填构建目录我会在源码旁边新建一个build-vs2019-x64文件夹注意构建目录永远不能在源码目录里否则后面增量编译会触发“源目录不干净”的报错。点 Configure第一次会让你选生成器这里直接选Visual Studio 16 2019右侧平台选x64。如果机器里装的是 VS2017就选Visual Studio 15 2017加x64。选错生成器是头号翻车点后面我会专门写。Configure 跑完后重点关注这些变量CMAKE_BUILD_TYPERelease 版填ReleaseDebug 版填Debug。这个变量会影响NOMINMAX的宏定义如果后续在自己项目里出现min/max与 std 冲突多半就是这里没设成多配置模式。BUILD_SHARED_LIBS我习惯勾选生成 DLL 方便运行时替换也避免多个静态库导致 exe 体积爆炸。如果你要发布单文件也可以取消勾选。BUILD_opencv_world勾上后所有模块合并成一个 opencv_world 库后续链接只需要opencv_world4100.lib省事很多。OPENCV_EXTRA_MODULES_PATH填 opencv_contrib 模块的modules目路径不填就只编译主库里的标准模块。WITH_OPENGL和WITH_QT没有强需求就不开开了反而需要额外下载 OpenGL 依赖或 Qt SDK。BUILD_opencv_python3如果你确定不要 Python 绑定取消它可以少编小半天。改完这些再点一次 Configure红色变量全部变白后点 Generate最后点 Open 直接打开 VS 工程。如果你不想点鼠标见下一小节。3.4 命令行生成方式用一行命令交出一致的构建配置GUI 适合新手但换机器时还是要重新点一遍很烦。推荐在拿到源码后直接用命令行生成把配置固化到 bat 脚本里。以 VS2019 x64 为例我的生成命令是这样cmake -S D:\opencv\opencv-4.1.0 -B D:\opencv\build-vs2019-x64 -G Visual Studio 16 2019 -A x64 -DCMAKE_BUILD_TYPERelease -DBUILD_SHARED_LIBSON -DBUILD_opencv_worldON -DOPENCV_EXTRA_MODULES_PATHD:\opencv\opencv_contrib-4.1.0\modules -DBUILD_opencv_python3ON-S指定源码根目录-B指定构建目录如果目录不存在 CMake 会自动创建。-G后面必须跟生成器名称要用Visual Studio 16 2019这种带引号的完整名不能只写Visual Studio。-A指定平台架构x64是必须的否则默认生成 Win32 工程后面 OpenCV 的 x64 库一个都链接不上。-D是缓存变量开关优先级比 GUI 里改的高。注意BUILD_opencv_python3要不要开取决于你有没有对应 Python 的 Debug 版本库。如果你机器的 Python 是官网安装的那没问题如果是 Windows Store 里面的精简版CMake 经常找不到python3_d.lib这种情况下我劝你直接关掉这个选项避免 Configure 卡很久。生成完成后构建目录里会出现OpenCV.sln后面你既可以用 VS 打开编译也可以用命令行继续构建cmake --build D:\opencv\build-vs2019-x64 --config Release --target ALL_BUILD -j 8--build后面的路径就是构建目录--config Release告诉 MSBuild 编译 Release 配置-j 8限制并行编译任务数防止内存不够导致 OOM。这条命令跑完OpenCV 的 install 目录里就会产出opencv_world4100.dll和对应的.lib文件接下来就能拿这些去自己项目里做find_package了。4. 避坑排查Windows 下 CMake 加 OpenCV 的 5 个经典坑每个都能让你白忙一晚上4.1 Configure 报错The source directory is not empty 或源码被污染现象CMake 第一次 Configure 就红字提示The source directory D:/opencv/opencv does not appear to contain CMakeLists.txt.或者The source directory is not empty。原因多数是把源码跟构建目录混在一起或者解压源码时把上一版的构建缓存CMakeCache.txt也带进去了还有的是因为手动编译失败后残留了CMakeFiles文件夹。解决构建目录永远新建一个干净文件夹。另外源码目录里不要出现CMakeCache.txt如果有直接删除。我会在解压 OpenCV 源码后先搜一遍CMakeCache*确保目录干净再开始配置。4.2 找不到 Python 或 OpenCV-Python 模块直接消失现象Configure 时 CMake 提示Could NOT find PythonInterp: Found unsuitable version 2.7...或者生成后lib\python3目录里没有cv2.pyd。原因Windows 上装了多个 Python 版本CMake 默认搜索注册表命中 Anaconda 的 base 环境或 Python 2.7 残留导致解释器和开发库版本不一致。新版 CMake 用了Python3模块但 3.14.2 还在用PythonInterp和PythonLibs两个变量互相独立经常一个找到 3.7、另一个找到 3.8。解决在 GUI 里手动搜索PYTHON_EXECUTABLE、PYTHON_INCLUDE_DIR、PYTHON_LIBRARY三个变量把它们指到同一个 Python 安装路径。命令行里可以直接追加-DPYTHON_EXECUTABLEC:/Python37/python.exe -DPYTHON_INCLUDE_DIRC:/Python37/include -DPYTHON_LIBRARYC:/Python37/libs/python37.lib注意用正斜杠避免反斜杠转义问题。如果还是不生成cv2.pyd干脆关掉BUILD_opencv_python3先保证 C 库能编出来后面再用 pip 安装官方 OpenCV 包也行。4.3 选的生成器和实际安装的 Visual Studio 对不上现象Configure 一直显示Generator: Visual Studio 16 2019但点击 Open 时 VS 报错说找不到工具集或者编译时提示MSB8020: The build tools for v142 cannot be found.原因CMake 的注册表探测只认 VS 的最新版本但机器上装的是 VS2017或者装了 VS2019 但 C 桌面开发组件没勾选。还有一种情况是你选了 VS2019但工程文件被旧版 VS 打开导致平台工具集被降级。解决打开“Visual Studio Installer”看“使用 C 的桌面开发”组件是否安装。然后确保 CMake 生成器和 VS 主版本严格一致VS2017 对应Visual Studio 15 2017VS2019 对应Visual Studio 16 2019。如果只有 VS2019但 CMake 列表里没有它重启一次 VS 安装器再检查。我一般重启电脑后重新打开 CMake GUI注册表读不到的问题多半就消失了。4.4 编译时内存爆掉或 fatal error C1083现象cmake --build跑一半MSBuild 报fatal error C1083: Cannot open compiler intermediate file或者直接报C1060: compiler is out of heap space。原因Windows 上 MSBuild 默认会启动尽可能多的编译进程如果你内存只有 8GOpenCV 几千个文件的会同时开 20 个 cl.exe每个吃掉 500MB很快内存见底。解决构建时强制限制并行数用/maxcpucount或-j。比如cmake --build D:\opencv\build --config Release -j 4我在 16G 内存的机器上一般限到 632G 内存才敢开到 12。另外可以临时增加虚拟内存到 16G 以上但治标不治本。如果编译到一半崩了不要重新整编直接再跑一次同样的命令MSBuild 会增量编译只补剩余文件。4.5 运行时提示找不到 opencv_world4100.dll现象编译成功生成了 exe但运行程序时弹窗The code execution cannot proceed because opencv_world4100.dll was not found.原因OpenCV 的动态库目录没有加到系统 PATHexe 运行时搜索 DLL 的路径列表里没有它。VS 调试时会自动复制依赖 DLL但如果你直接双击 exe 或在 CMD 里跑就会缺。解决把构建目录下install\x64\vc16\bin加入 PATH或者把opencv_world4100.dll复制到 exe 同级目录。我建议用 set PATH 的方式在启动脚本里临时加set PATHD:\opencv\build-vs2019-x64\install\x64\vc16\bin;%PATH%不要修改全局系统 PATH免得多个 OpenCV 版本互相打架。如果你用的静态库BUILD_SHARED_LIBSOFF则不需要这一步。5. 进阶写一个可复用的 build_opencv.bat下次直接一键构建用 GUI 点配置的第一次会花 20 分钟但第二次我绝不再手点。我会把整个构建过程固化成一个 bat 脚本里面放一个“配置变量区”每次改几行就能适配新环境。下面是一个我常用的最小脚本echo off set SRCD:\opencv\opencv-4.1.0 set CONTRIBD:\opencv\opencv_contrib-4.1.0\modules set BUILDD:\opencv\build-vs2019-x64 set GENERATORVisual Studio 16 2019 set ARCHx64 set PYTHON_EXED:\Python37\python.exe set PYTHON_INCLUDED:\Python37\include set PYTHON_LIBD:\Python37\libs\python37.lib cmake -S %SRC% -B %BUILD% -G %GENERATOR% -A %ARCH% ^ -DCMAKE_BUILD_TYPERelease ^ -DBUILD_SHARED_LIBSON ^ -DBUILD_opencv_worldON ^ -DOPENCV_EXTRA_MODULES_PATH%CONTRIB% ^ -DPYTHON_EXECUTABLE%PYTHON_EXE% ^ -DPYTHON_INCLUDE_DIR%PYTHON_INCLUDE% ^ -DPYTHON_LIBRARY%PYTHON_LIB% ^ -DBUILD_opencv_python3ON cmake --build %BUILD% --config Release -j 8这个脚本的关键点是^续行符它告诉 CMD 下一条命令还是同一行。注意-G后面带空格的生成器名称一定要用双引号包住而%GENERATOR%变量本身已经包含空格所以脚本里我用了%GENERATOR%相当于 CMake 接收到的参数是-G Visual Studio 16 2019。如果你用的变量路径里有空格比如C:\Program Files\...则每次-D后面也要用引号包住变量值否则 CMake 会把它拆成多个参数。如果你不需要 Python 绑定把PYTHON_*三行删掉同时把-DBUILD_opencv_python3ON改成OFF或直接删除。这样 Config 阶段会少很多探测步骤失败概率下降一大截。编译时也可以只编需要的模块比如只编 core、imgproc、highgui用-DBUILD_LISTcore,imgproc,highgui能省一半时间但前提是你的代码不依赖其他模块。拿到open_world库和头文件后你自己的项目里只需要三行 CMake 就能用上find_package(OpenCV REQUIRED) include_directories(${OpenCV_INCLUDE_DIRS}) target_link_libraries(my_project PRIVATE ${OpenCV_LIBS})这里有个易踩的细节find_package(OpenCV)必须开启CMAKE_PREFIX_PATH否则 CMake 找不到安装目录。在你自己项目的 CMakeLists.txt 开头加set(CMAKE_PREFIX_PATH D:/opencv/build-vs2019-x64/install)要注意 install 目录是从哪来的。你手动编译 OpenCV 时如果不执行cmake --install则 install 目录不会生成最终find_package时OpenCV_DIR只能指向构建目录里OpenCVConfig.cmake所在的位置。因此我建议构建完成后单独跑一次安装cmake --install D:\opencv\build-vs2019-x64 --config Release --prefix D:\opencv\install--prefix可以自定义安装根目录后面你就可以把install整个拷给同事或别的机器不用再重新编译。我习惯把 install 目录整理成一个干净的 SDK 目录只保留 include、lib、bin这样即使构建目录没了我依然能链接。从那以后我每次搭 OpenCV 环境都强制走一遍这个脚本先改set SRC和set BUILD然后跑一次配置变量全部由脚本固定不会手滑漏掉-A x64或搞错 Python 路径。有一次我在新机器上直接双击脚本结果 Configure 还是报错原因是脚本里的PYTHON_LIB路径是老的 3.6新机器装的是 3.8我花了两分钟改成机器上的实际路径之后二十分钟就编译完了——比从 GUI 点起快了一个钟头。这份踏实感就是值得为 CMake 3.14.2 多花几分钟的理由希望帮到你。本文还有配套的精品资源点击获取
平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测)
