Windows 上下载、编译 OpenCV 并配置系统环境变量的详细步骤

news2024/12/24 22:13:14

opencv

创作不易，您的打赏、关注、点赞、收藏和转发是我坚持下去的动力！

在 Windows 上下载并编译 OpenCV，然后配置系统环境变量的步骤如下：

1. 下载 OpenCV

打开 OpenCV 官方下载页面。
找到最新的 Windows 版本，点击下载，例如：opencv-4.x.x-vc14_vc15.exe，这将是一个自解压文件。
下载完成后，双击 opencv-4.x.x-vc14_vc15.exe 文件，选择一个目录将其解压，例如：C:\，解压后，你会得到一个文件夹，如：C:\opencv\。

2. 安装 CMake

下载并安装 CMake（选择 Windows 64-bit 版本）。
安装完成后，将 CMake 添加到系统环境变量中（安装时可以选择自动添加）。

3. 配置 OpenCV 源码

进入解压后的 opencv 文件夹，你会看到一个 sources 文件夹，其中包含 OpenCV 源码。
为了编译 OpenCV，需要创建一个用于构建的目录，例如：C:\opencv\build。

4. 使用 CMake 配置 OpenCV

打开 CMake GUI。
在 Where is the source code: 中选择 OpenCV 的 sources 文件夹路径，如：C:\opencv\sources。
在 Where to build the binaries: 中选择刚才创建的 build 文件夹路径，如：C:\opencv\build。
点击 “Configure” 按钮，弹出的窗口中选择你的编译器（例如，Visual Studio 16 2019）并选择构建平台（默认是 x64），然后点击“Finish”。
CMake 开始检查环境并配置 OpenCV 编译设置。这个过程可能需要几分钟，完成后，CMake GUI 下方会显示一系列的配置选项。
在配置选项中，你可以选择你需要的模块，例如可以勾选 WITH_IPP，WITH_CUDA，WITH_OPENGL 等。如果不确定，可以保持默认设置。
再次点击 “Configure” 进行更新配置。
配置完成后，点击 “Generate” 生成 Visual Studio 项目文件。
生成完成后，点击 “Open Project” 打开生成的 Visual Studio 项目文件（.sln）。

5. 使用 Visual Studio 编译 OpenCV

在 Visual Studio 中打开 OpenCV.sln 项目文件。
选择 Release 模式，右键单击解决方案，选择 “生成解决方案”。这将会开始编译 OpenCV。编译时间较长，具体取决于你的电脑配置。
编译完成后，生成的库文件（.lib 和 .dll）将位于 C:\opencv\build\install\x64\vc16\lib 和 C:\opencv\build\install\x64\vc16\bin 目录下。

6. 设置 OpenCV 系统环境变量

为了方便在其他项目中使用 OpenCV，需要将 OpenCV 的库路径添加到系统环境变量中。

打开 控制面板 > 系统和安全 > 系统 > 高级系统设置。
在“高级”选项卡中，点击 “环境变量”。
在“系统变量”中找到 Path 变量，双击编辑。
点击 “新建”，添加以下路径：
- OpenCV 的 bin 目录路径，例如：C:\opencv\build\install\x64\vc16\bin。
你还可以创建一个新的系统变量，以便在 Visual Studio 项目中引用：
- 点击 “新建”，名称为 OpenCV_DIR，值为 OpenCV 编译后的安装目录，例如：C:\opencv\build\install。

7. 验证 OpenCV 安装

打开命令提示符，输入以下命令以验证环境变量是否正确设置：
```
echo %OpenCV_DIR%
```
如果显示的是你设置的 OpenCV 路径，说明环境变量配置成功。

编写一个简单的 OpenCV 程序进行测试，例如一个显示图像的程序。使用 Visual Studio 创建一个新的 C++ 项目，编写如下代码：

#include <opencv2/opencv.hpp>

int main() {
    cv::Mat image = cv::imread("path_to_your_image.jpg");
    if (image.empty()) {
        std::cout << "Could not open or find the image!" << std::endl;
        return -1;
    }
    cv::imshow("Display window", image);
    cv::waitKey(0);
    return 0;
}

配置 Visual Studio 项目属性：
- 在项目属性中，添加 OpenCV 头文件和库路径：
  - C/C++ -> 常规 -> 附加包含目录：添加 C:\opencv\build\install\include。
  - 链接器 -> 常规 -> 附加库目录：添加 C:\opencv\build\install\x64\vc16\lib。
- 在 链接器 -> 输入 -> 附加依赖项 中，添加 OpenCV 库文件，例如：
```
opencv_world460.lib  // 根据你安装的 OpenCV 版本号
```