Windows VSCode 配置 MinGW 与手动编译安装 OpenCV 实战

访问 OpenCV 官网 下载 Windows 版本的 .exe 安装包，运行后解压到指定目录。

2.2 环境变量配置

将 OpenCV 的 bin 路径添加到环境变量。此外，需将以下三个 DLL 文件复制到 C:\Windows\System32 目录下，避免运行时缺失依赖：

• opencv_videoio_ffmpeg4100_64.dll
• opencv_world4100.dll
• opencv_world4100d.dll

三、CMake 安装

3.1 下载与安装

前往 CMake 官网 下载 Windows 安装包并安装。

3.2 环境变量

将 CMake 的 bin 路径加入系统 Path。

3.3 验证

cmake --version

四、编译和构建

4.1 CMake 配置

通过 CMake GUI 生成 Makefile 文件。

4.1.1 创建构建目录

在 OpenCV 源码目录下的 build\x64 中新建一个文件夹（例如 MinGW），用于存放生成的构建文件。

4.1.2 配置参数

以管理员身份运行 cmake-gui.exe：

1. Source code: 指向 OpenCV 源码根目录。
2. Build binaries: 指向刚才创建的 MinGW 构建目录。
3. 点击 Configure，选择 MinGW Makefiles 作为生成器。
4. 确保 CMAKE_C_COMPILER 和 CMAKE_CXX_COMPILER 指向你的 gcc.exe 和 g++.exe。

4.1.3 关键选项勾选

配置完成后，重点勾选以下选项以确保核心功能可用：

• BUILD_opencv_world: 必须勾选，打包所有模块。
• WITH_FFMPEG: 启用视频支持。
• CPU_DISPATCH: 保持为空，避免特定指令集报错。

4.1.4 解决报错

配置过程中若出现网络错误，请查看 CMakeDownloadLog.txt 获取失败文件的链接，手动下载后放入对应目录重试。

4.1.5 生成

点击 Generate 按钮，确认无红色报错后完成配置。

4.2 编译构建

进入构建目录（如 build\x64\MinGW），使用并行编译加速：

mingw32-make.exe -j 12

-j 12 表示使用 12 个线程并行编译，多核机器可显著提升速度。

4.3 安装

编译成功后，执行安装命令将库文件部署到指定位置：

mingw32-make.exe install

安装完成后，将 install\bin 路径再次添加到系统环境变量 Path 中，确保运行时能找到动态库。

五、VSCode 中配置 OpenCV

5.1 测试代码

新建一个 .cpp 文件，编写简单的图像读取测试代码：

#include <iostream>
#include <opencv2/opencv.hpp>

using namespace std;
using namespace cv;

int main() {
    // 指定图片路径
    string path = "Images/0.bmp";
    cv::Mat img = imread(path);

    // 显示图像
    imshow("Display Image", img);
    
    // 等待按键按下，关闭窗口
    waitKey(0);
    return 0;
}

5.2 c_cpp_properties.json 配置

按 Ctrl+Shift+P 打开命令面板，搜索 C/C++: Edit Configurations (UI)。 设置编译器路径为 MinGW 的 g++.exe，并将 OpenCV 的头文件路径（通常在 install\include）添加到 includePath。

5.3 tasks.json 配置

用于定义编译任务。按 Ctrl+Shift+P -> Tasks: Configure Default Build Task -> C/C++: g++.exe build active file。 修改生成的 tasks.json 内容如下，确保调用正确的编译器：

{
    "version": "2.0.0",
    "tasks": [
        {
            "type": "cppbuild",
            "label": "C/C++: g++.exe build active file",
            "command": "F:/APP/MinGW/mingw64/bin/g++.exe",
            "args": [
                "-fdiagnostics-color=always",
                "${file}",
                "-o",
                "${fileDirname}/${fileBasenameNoExtension}.exe"
            ],
            "options": {
                "cwd": "${fileDirname}"
            },
            "problemMatcher": [
                "$gcc"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            }
        }
    ]
}

5.4 launch.json 配置

用于调试配置。点击菜单栏 Debug -> Start Debugging，选择 C++ (GDB/LLDB)。 修改 launch.json 中的调试器路径和程序路径：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "(gdb) Launch",
            "type": "cppdbg",
            "request": "launch",
            "program": "${fileDirname}/${fileBasenameNoExtension}.exe",
            "args": [],
            "stopAtEntry": false,
            "cwd": "${fileDirname}",
            "environment": [],
            "externalConsole": true,
            "MIMode": "gdb",
            "miDebuggerPath": "F:/APP/MinGW/mingw64/bin/gdb.exe",
            "setupCommands": [
                {
                    "description": "Enable pretty-printing for gdb",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ],
            "preLaunchTask": "C/C++: g++.exe build active file"
        }
    ]
}

5.5 验证配置

运行测试脚本，若能正常弹出窗口显示图像，说明配置成功。

六、总结

至此，Windows 下 VSCode + MinGW + OpenCV 的手动编译与配置流程已完成。整个过程涉及多个环境变量的设置和 CMake 的参数调整，遇到报错时多检查日志和依赖文件是否完整。如果本地编译实在困难，后续也可考虑直接使用预编译好的第三方库版本。