【VSCode】【OpenCv】Windows平台下VSCode + OpenCv + minGw环境搭建-C++

参考链接：VScode搭建Opencv（C++开发环境）

1. 软件准备

• MinGw：x86_64-posix-seh
  

• CMake：cmake-3.20.2-windows-x86_64.zip
  

• OpenCv：opencv-4.5.2-vc14_vc15.exe
  

2. 配置环境变量

将上述下载的MinGw、CMake、OpenCv解压到指定文件夹内，本机测试都放在D:\IDE文件夹内，文件路径如下：

---

MinGw：D:\IDE\MinGw

---

CMake：D:\IDE\cmake

---

OpenCv：D:\IDE\opencv452\opencv

---

在系统环境变量path中添加MinGw、CMake：

• MinGw：D:\IDE\MinGw\bin；
• CMake：D:\IDE\cmake\bin；
  
  检查MinGw、CMake环境是否OK。
  打开cmd命令窗口，输入gcc -v判断MinGw环境，输入cmake -version判断CMake环境。显示如下表示环境配置成功。
  

3. 使用CMake编译Opencv

1. 在CMake/bin文件夹下找到cmake-gui.exe，双击打开。
   
2. 设置第一个路径(Where is the source code)是opencv的源码路径，第二个路径(Where to build the binaries)是生成的文件的路径(手动创建ming文件夹)。
   
3. 点击Configure，然后选择使用MinGw MakeFiles作为编译器，并选择Specify native compliers，点击next继续，

4. CompliersC选择mingw/bin文件夹下的gcc.exe，C++选择mingw/bin文件夹下的g++.exe，然后点击finish继续。

5. 等完成后可能会有红色的框表示失败了，这时候看一下CMakeDownloadLog.txt文件，应该是有几个文件没有下载下来，可以手动下载，然后把它们放到指定文件夹内并重命名。大概就是这几个文件需要手动下载：opencv_videoio_ffmpeg.dll、opencv_videoio_ffmpeg_64.dll、ade-0.1.1f.zip、ffmpeg_version.cmake。

下载失败解决方案可参考：CMake编译OpenCV4.0时opencv_ffmpeg.dll等下载失败的解决思路总结。
国内访问受限，GitHub Proxy可以下载需要的文件。

6. 下载完成后再重新点击Configure，等待完成即可。如果完成后仍然还有红色框出现，不要着急，再重新点击Configure即可。
7. 执行完后，把python相关的都取消勾选，
   WITH_IPP、WITH_MSMF、ENABLE_PRECOMPILED_HEADERS取消勾选；
   BUILD_opencv_world、WITH_OPENGL、BUILD_EXAMPLES选择勾选，
   CPU_DISPATCH选空。
8. 上述操作完成后点击Generate，直到操作完成。
   

4. make

重新打开cmd窗口，进入刚刚生成的mingw文件夹，执行命令：minGW32-make -j 4。
没有出错，继续执行命令：minGW32-make install。
然后添加环境变量：

5. VSCode配置并测试

1. 新建一个文件夹，命名为Hello-opencv
2. 使用VSCode打开该文件夹；
3. 在该文件夹下新建一个文件，命名为test.cpp;
4. 编写如下代码，记得该文件夹下放一个图片；

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

using namespace cv;
using namespace std;

int main()
{
    std::string filename = "1.jpg";
    cv::Mat srcimg = cv::imread(filename.data());
    if (!srcimg.empty())
    {
        cv::namedWindow("test", cv::WINDOW_NORMAL);
        cv::imshow("test", srcimg);
        cv::waitKey(0);
    }
    else
    {
        printf("load image fail!\n");
        getc(stdin);
    }

    return 0;
}

5. 点击调试 C/C++文件，选择带g++.exe，会出现提示***存在错误，点击中止即可；
   
   
   
6. 在Hello-opencv文件夹下会手动创建.vscode文件夹，.vscode文件夹下手动创建三个文件：c_cpp_properties.json、launch.json、tasks.json，然后按照如下编辑这些json文件。这些字段的具体含义可参考：VSCode Variables Reference。

这三个文件也可以自动生成，这里只展示手动创建的过程。
路径要根据自己电脑设置的路径填写。

c_cpp_properties.json

{
    "configurations": [
        {
            "name": "win",
            "includePath": [
                "${workspaceFolder}/**",
                "D:\\IDE\\opencv452\\opencv\\build\\x64\\mingw\\install\\include",
                "D:\\IDE\\opencv452\\opencv\\build\\x64\\mingw\\install\\include\\opencv2"
            ],
            "defines": [],
            "compilerPath": "D:\\IDE\\MinGw\\bin\\g++.exe",
            "cStandard": "c11",
            "cppStandard": "c++17",
            "intelliSenseMode": "${default}"
        }
    ],
    "version": 4
}

tasks.json

{
    "version": "2.0.0",
    "tasks": [
        {
            "type": "shell",
            "label": "opencv4.5.2",
            "command": "D:\\IDE\\MinGw\\bin\\g++.exe",
            "args": [
                "-g",
                "${file}",
                "-o",
                "${workspaceFolder}\\RBin\\${fileBasenameNoExtension}.exe",
                // RBin是自定义的文件夹名，会把生成的EXE放在该文件夹下，要手动创建RBin文件夹
                // 下面的opencv路径根据自己的路径修改
                "D:\\IDE\\opencv452\\opencv\\build\\x64\\mingw\\bin\\libopencv_world452.dll",
                "-I",
                "D:\\IDE\\opencv452\\opencv\\build\\x64\\mingw\\install\\include",
                "-I",
                "D:\\IDE\\opencv452\\opencv\\build\\x64\\mingw\\install\\include\\opencv2",
            ],
            "options": {
                "cwd": "D:\\IDE\\MinGw\\bin"
            },
            "problemMatcher": [
                "$gcc"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            }
        }
    ]
}

launch.json

{
    // 使用 IntelliSense 了解相关属性。 
    // 悬停以查看现有属性的描述。
    // 欲了解更多信息，请访问: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
        {
            "name": "opencv debuge",
            "type": "cppdbg",
            "request": "launch",
            "program": "${workspaceFolder}\\RBin\\${fileBasenameNoExtension}.exe",
            "args": [],
            "stopAtEntry": false, // true表示运行到main()函数的第一行，可以调试；false表示直接运行，不会再main()函数的第一行停止，除非设置了断点
            "cwd": "${workspaceFolder}",
            "environment": [],
            "externalConsole": true,//是否调用外部cmd
            "MIMode": "gdb",
            "miDebuggerPath": "D:\\IDE\\MinGw\\bin\\gdb.exe",//自己进行设置
            "setupCommands": [
                {
                    "description": "为 gdb 启用整齐打印",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": false
                }
            ],
            "preLaunchTask": "opencv4.5.2",
            "console": "integratedTerminal",
            "justMyCode": true
        }
    ],
    
}

7. 转到test.cpp编辑界面，然后按F5，如果当前路径下(Hello-open)没有图片，则会提示load image fail!；如果路径下有图片，会显示图片。
   这两种情况都表示配置已经完成，以后如果在其它文件夹下开发，可以直接把.vscode文件夹拷过去。
   
   

6. 注意事项

如下是本机测试时出现的问题。

1. cmake添加了环境变量但是cmd窗口中输入命令提示不是内部或外部命令。
   添加环境变量后需要重新打开cmd；
2. 一定要记得CMake编译时，Configure完成后一定要generate!!!
3. 选择config的编译器时一定要选对。这个我第一次配置的时候选错了，后面执行 minGW32-make -j 4命令时总是提示Makefile:32: *** missing separator. Stop.，找了好多解决方案都不行，最后重新来一遍才发现。
4. python等要取消勾选。
5. 如果第二次configure还是有红色的，不要慌，再点击configure，直到没有红色出现。
6. 第一次configure出现红色的，查看CMakeDownloadLog.txt，下载几个需要的文件；然后把它们放入到对应的路径下。
7. 运行时要手动创建RBin文件夹。
8. 以.vscode所在目录(测试的Hello-opencv\)为当前工作路径。
9. 环境变量中的opencv路径一定要写对。
10. 调用其它文件的函数时，要把头文件和源文件都包含进去。这个是后面写其它代码的时候一个文件要调用另一个文件内的函数，需要把那个函数声明和定义的文件都包含在内。
    如下：
    b.h

void b_b();

b.cpp

void b_b()
{
	// 函数实现
}

a.cpp

// a.cpp中要包含函数b_b()的声明和定义的文件
#include "b.h"
#include "b.cpp"

int main()
{
	b_b();  // 在b.h中声明的函数
	return 0;
}