企业官网建设流程全解析

在 Microsoft Visual Studio 中配置 OpenCV C++ 工程：DLL/静态库原理、Property Sheet 配置与实战验证

【免费下载链接】opencvOpen Source Computer Vision Library项目地址: https://gitcode.com/GitHub_Trending/opencv31/opencv

本指南对应 OpenCV 官方入门教程“How to build applications with OpenCV inside the Microsoft Visual Studio”（原文位于 doc/tutorials/introduction/windows_visual_studio_opencv/windows_visual_studio_opencv.markdown，作者 Bernát Gábor，适用范围 OpenCV >= 3.0）。文章围绕 Windows + Visual Studio 场景下 C/C++ 工程的完整搭建链路展开：先理解 OpenCV 以 DLL/静态库两种形态交付的差异，再掌握编译期“头文件可见”、链接期“库文件可寻”的本质，随后以“局部 Property Sheet”与“全局属性页”两种方式完成 IDE 配置，最后用仓库自带示例程序跑通读图显示全流程，并学会通过命令行参数驱动程序。

注意：原教程多次提示可能存在过时信息（@warning标记）。文中所有截图与界面路径以传统 Visual Studio（2008/2010 起，2013 之后 Property Manager 菜单位置变化）为基准，不同版本菜单文字可能略有差异，核心配置逻辑保持一致。

1. 动手前的先决条件

本教程默认你已经完成 Windows 版 OpenCV 的安装教程（见 windows_install 安装向导），并满足两点：

1. 磁盘上已存在一个包含 OpenCV头文件与二进制库的安装目录；
2. 已按该安装教程设置好环境变量，尤其应定义OPENCV_DIR。

安装后的典型目录形态如下（源自教程配图）：

典型的 OpenCV 预编译包在 Windows 下解压后的布局为：

• build/include：opencv2/...系列头文件目录；
• build/x64/vc<NN>/bin：运行期所需的*.dll；
• build/x64/vc<NN>/lib：链接期所需的*.lib（含导入库与静态库）。

而环境变量OPENCV_DIR需要指向“同时含lib与bin两个子文件夹”的那一级目录，例如在 windows_install 教程的环境变量一节中给出了针对不同 Visual Studio 版本的典型命令：

setx OpenCV_DIR D:\OpenCV\build\x64\vc15 (Visual Studio 2017 - 64 位) setx OpenCV_DIR D:\OpenCV\build\x64\vc16 (Visual Studio 2019 - 64 位) setx OpenCV_DIR D:\OpenCV\build\x64\vc17 (Visual Studio 2022 - 64 位)

随后再把bin目录写入系统PATH，即追加：

%OPENCV_DIR%\bin

这样操作系统才能在运行期定位到 DLL。若跳过这一步，运行 exe 时通常需要把 OpenCV 的 DLL 手动复制到 exe 同目录，多工程开发时非常不便。

2. 先理解“库的形态”：DLL 与静态库的取舍

Windows 上官方发布的 OpenCV 二进制通常以DLL（动态链接库）形态提供。DLL 的库内容仅在运行时按需加载，多个程序可以共享同一个库文件——十个应用使用 OpenCV，只需系统里有一份 DLL 即可；代价是任何要运行你的程序的目标机器上，都必须带齐对应的 OpenCV DLL。

另一条路线是使用.lib静态库：通过源码自行编译得到（方法仍见 windows_install 安装向导）。静态链接会把库内容“内嵌”进你的 exe，用户不会因 DLL 缺失而运行失败；代价是 exe 体积更大、启动加载时间更长。

Windows 特有的细节：使用 DLL 时，链接器必须知道“某个函数/数据结构在 DLL 里的位置”，这段信息存放在伴随 DLL 生成的lib文件中。这类lib不是静态库，而是所谓的导入库（import library）。因此你用 Visual Studio 生成 DLL 时总会同时得到若干.lib；运行期真正被需要的只有 DLL。

无论静态还是动态，要在 Visual Studio 里构建 OpenCV 应用，本质上只做两件事：

• 告诉编译器 OpenCV 的“长相”——把头文件目录交给编译器（Additional Include Directories）；
• 告诉链接器“从哪里取实现”——把库目录与具体库名交给链接器（Additional Library Directories / Additional Dependencies）。

对 DLL 形态来说，编译器需要你在 IDE 中显式给出这些信息，是因为导入库承载着运行期查表所需的信息；这属于微软操作系统特有的机制。

3. 传递配置的两条路径：局部配置与全局配置

把上述信息交给 Visual Studio 有两种粒度：

• 局部配置（本教程主推）：只对当前工程生效，通过“Property Sheet（属性表）”复用，不污染其他工程；
• 全局配置：对所有工程生效，只需设置一次，但通常只覆盖“头文件与库目录”，具体链接哪些库仍需在工程内手动指定。

先建立几个 Visual Studio 的基本概念：一个解决方案（Solution）可以包含多个工程（Project），工程是应用的构建单元；教程中的大多数简单示例只有一个主工程。每个工程按构建模式至少分成Debug（带调试辅助、便于找 Bug）与Release（追求运行速度或最小体积）两套规则包，这些规则包在 IDE 里叫工程属性（Project Properties），通过Property Manager查看与编辑。

新建工程路径：File --> New --> Project，类型选Win32 Console Application，输入名称与存放路径后，在后续对话框中务必勾选创建空工程（Empty project）。

4. 局部配置法：用 Property Sheet 把 OpenCV 规则沉淀下来

Property Sheet 最大的价值在于“一次创建、处处复用”：你只需在任意一个工程里做一次完整配置，之后新建 OpenCV 工程时一键挂载即可。因为 Debug 与 Release 需要不同的规则，我们需要分别建两套。

4.1 打开 Property Manager 并新建属性表

打开菜单View --> Property Manager（Visual Studio 2013 起位于View --> Other Windows --> Property Manager）。展开后即可看到工程现有的规则包。右键当前工程的Debug配置，选择Add New Property Sheet：

命名为OpenCV_Debug后，右键该属性表选择Properties，开始填充 OpenCV 规则。

小技巧：如果工程里找不到C/C++配置组，先向工程添加任意一个.c/.cpp源文件，该配置组即会出现——配置面板会依据源文件类型决定是否展示编译器选项。

4.2 填入头文件目录（编译器可见性）

进入C/C++ --> General --> Additional Include Directories，添加指向 OpenCV include 目录的路径。强烈推荐使用环境变量而非写死绝对路径：OpenCV 的安装位置在不同机器上可能不同，一旦你移动安装目录或将工程交给路径不同的同事，写死的路径就会失效，且需逐条手工修改。Visual Studio 会把$(...)内的符号在配置期展开为当前环境变量值。利用前面设置好的OPENCV_DIR，填写：

$(OPENCV_DIR)\..\..\include

OPENCV_DIR指向build\x64\vc<NN>，因此..\..\include实际解析到build\include，与预编译包的目录约定一致。若头文件未在此目录下，也可直接填安装包里 include 的真实位置。

4.3 填入库文件目录（链接器搜索路径）

进入Linker --> General --> Additional Library Directories，同样使用环境变量指定lib目录：

$(OPENCV_DIR)\lib

4.4 填入需要链接的具体库名

进入Linker --> Input --> Additional Dependencies，把你实际用到的模块逐个加进来。

# Debug 版库名命名约定：模块名 + 版本号 + d + .lib，其中 d 表示 debug opencv_(The Name of the module)(The version Number of the library you use)d.lib

以 OpenCV 3.0 时代预编译包为例，Debug 完整列表如下：

opencv_calib3d300d.lib opencv_core300d.lib opencv_features2d300d.lib opencv_flann300d.lib opencv_highgui300d.lib opencv_imgcodecs300d.lib opencv_imgproc300d.lib opencv_ml300d.lib opencv_objdetect300d.lib opencv_photo300d.lib opencv_shape300d.lib opencv_stitching300d.lib opencv_superres300d.lib opencv_ts300d.lib opencv_video300d.lib opencv_videoio300d.lib opencv_videostab300d.lib

命名中的版本数字随发行版而变化（例如 3.0.0 →300；教程提到 3.3.0 时代可用opencv_world330.lib），因此最稳妥的做法是打开你自己的build\x64\vc<NN>\lib目录，按实际存在的文件名抄录。若你的下载把全部模块合成单一大库，则只需添加一个（Release 无d后缀）：

opencv_world330.lib

需要说明的是，模块合并能力正是由BUILD_opencv_world这一 CMake 选项控制的——开启后生成包含所有模块的单一opencv_world二进制（共享或静态取决于BUILD_SHARED_LIBS），而非每模块一个独立二进制，可参见本仓库 modules 顶层构建脚本 与 CMake 顶层配置 中的相关选项说明。相应地，本仓库根目录的include/opencv2也体现了头文件的统一组织方式（include/opencv2）。

教程中会同时用到highgui、imgcodecs与core——运行示例只需要读图与显示，这三个模块即足够：

opencv_core300d.lib opencv_imgcodecs300d.lib opencv_highgui300d.lib

填写完毕保存 Debug 属性表；随后在Release配置下重复同样流程新建OpenCV_Release属性表，务必去掉库名末尾的d：

属性表保存后出现在工程目录下：Visual Studio 2010 及以后扩展名为*.props，2008 为*.vsprops。强烈建议把它们备份到专门的公共目录，此后每个 OpenCV 工程只需在 Property Manager 中右键Add Existing Property Sheet...即可一键挂载：

5. 全局配置法：一劳永逸但粒度更粗

若不想在每个工程里逐个挂属性表，也可以把规则放进“全局属性页”。需要重申：该方式只覆盖附加包含目录与附加库目录；具体链接哪些库仍需在工程内（例如属性页中）手动指定。

• Visual Studio 2008：入口在Tools --> Options --> Projects and Solutions --> VC++ Directories，在相应列表里追加 include 目录与 lib 目录即可。
• Visual Studio 2010 及以后：该功能被挪到一张“自动附加到每个新建工程的全局属性表”中，配置过程与局部方式一致，仍使用OPENCV_DIR展开头文件与库路径。

全局方式的好处是只需配一次；坏处是会让所有工程（哪怕是毫不相关的）长期背着这套规则，教程作者本人倾向局部方式以避免“污染”无关工程。

6. 实战验证：编译并运行仓库自带示例

仓库在samples/cpp/tutorial_code/introduction/windows_visual_studio_opencv/下提供了本教程配套的测试源码 introduction_windows_vs.cpp。把它加入工程并构建，其完整内容如下：

#include <opencv2/core.hpp> #include <opencv2/imgcodecs.hpp> #include <opencv2/highgui.hpp> #include <iostream> using namespace cv; using namespace std; int main( int argc, char** argv ) { if( argc != 2) { cout <<" Usage: " << argv[0] << " ImageToLoadAndDisplay" << endl; return -1; } Mat image; image = imread(argv[1], IMREAD_COLOR); // Read the file if( image.empty() ) // Check for invalid input { cout << "Could not open or find the image" << std::endl ; return -1; } namedWindow( "Display window", WINDOW_AUTOSIZE ); // Create a window for display. imshow( "Display window", image ); // Show our image inside it. waitKey(0); // Wait for a keystroke in the window return 0; }

这段示例本身就是对“编译与链接配置是否成功”的完整回归测试，其依赖链清晰可见：

• <opencv2/core.hpp>→ 依赖core模块（Mat数据结构的定义处）；
• <opencv2/imgcodecs.hpp>→ 依赖imgcodecs模块（imread负责解码图片）；
• <opencv2/highgui.hpp>→ 依赖highgui模块（namedWindow/imshow/waitKey负责窗口显示与事件等待）。

三处头文件分别对应你在 4.4 节填入的三个导入库，若漏配任一模块，编译（头文件缺失）或链接（未解析的外部符号）阶段就会报错——这正是 4.2～4.4 三步配置价值的直观印证。运行时流程为：imread以IMREAD_COLOR模式读入 argv[1] 指定的图像到Mat，用image.empty()校验读入失败，再经namedWindow+imshow弹出窗口，最后waitKey(0)阻塞等待按键。

构建后可选择两种方式运行，但两者行为并不相同：

• 从 IDE 启动（快捷键Ctrl+F5）：进程当前工作目录是工程目录，且控制台窗口在程序结束后不会自动关闭，会等待你按键；
• 直接双击 exe 或从命令行运行：当前工作目录是 exe 所在目录（通常是构建输出目录）。

工作目录差异非常关键：程序内所有相对路径的读写（如本示例的imread(argv[1], ...)）都相对于工作目录解析，除非你传入完整的绝对路径。示例打开的是仓库测试数据中的 opencv-logo.png，运行前请把该图片（或其他任意图片）放到你的当前工作目录，并把argv[1]换成相应文件名：

MySolutionName.exe opencv-logo.png

运行成功应弹出带 OpenCV logo 的独立窗口：

7. 给程序传命令行参数：cmd 直启与 IDE 自动化

OpenCV 后续很多教程示例都以“运行期参数”作为主要输入方式，例如上例的图片路径。两种传参途径：

方式一：命令窗口手动启动。在开始菜单搜索cmd回车，切换到 exe 所在目录后带参启动：

D: CD OpenCV\MySolutionName\Release MySolutionName.exe exampleImage.jpg

第一行切换盘符（若工程不在系统盘），第二行进入构建输出目录，第三行携带图像参数启动。Linux 用户习惯在终端里操作，而 Windows 上许多人几乎从不碰控制台；更麻烦的是，反复测试同一应用要不断重敲参数。

方式二：Visual Studio 内置参数注入。打开工程属性，定位到Debugging --> Command Arguments（即Configuration Properties --> Debugging），填入每次从 IDE 启动都要自动传入的参数，例如exampleImage.jpg：

此后按Ctrl+F5从 IDE 启动，参数会被自动附加到命令行。这与 6 节描述的工作目录规则叠加使用时要注意：参数里的相对路径将按“工程目录”解析。

8. 常见坑位与自检清单

汇总以上机制，若配置后构建或运行出错，按顺序排查：

1. Debug/Release 库不匹配：Debug 工程务必链接带d后缀的库，Release 反之；混用常引发链接器报错或运行期行为异常。
2. 链接的库少了：头文件已见但链接失败（LNK2019/2001 类“无法解析的外部符号”），通常是对应模块的.lib未加入Additional Dependencies。
3. 运行期找不到 DLL：程序构建成功但双击报“缺少 opencv_*.dll”，说明%OPENCV_DIR%\bin未加入系统PATH，或换机运行未携带 DLL（见第 1、2 节）。
4. 库名照抄教程出错：库名中的版本号随发行版与工具链变化（300/330/世界库差异），务必以自己lib目录里的真实文件名为准。
5. 相对路径打不开图片：注意从 IDE 启动与命令行/双击启动的工作目录不同（见第 6 节），优先给 I/O 函数传绝对路径或把资源放入对应工作目录。

配置一旦跑通，核心经验可以沉淀为一张可复用的OpenCV_Debug.props/OpenCV_Release.props，后续所有 OpenCV 工程通过 Property Manager 的Add Existing Property Sheet...秒级接入，无需重复第 4 节的任何步骤。

【免费下载链接】opencvOpen Source Computer Vision Library项目地址: https://gitcode.com/GitHub_Trending/opencv31/opencv