win10 系统 VSCODE 配置opencv

之前一直在Linux系统下使用OpenCV或在Windows系统下VC配置OpenCV，今天换了新电脑特地配置了一下vscode 环境下的使用，遇到一点波折，特记录一下。

1.下载MinGW并配置环境变量

下载 mingw到本地。

 下载该文件后解压，解压路径视为安装路径，可改名为mingw64。

添加环境变量。D:\Program Files (x86)\mingw64\bin
在bin目录下输入cmd，调出 cmd命令窗口。输入: gcc -v 查看版本信息确认配置成功。

 2. 下载Cmake并配置环境变量

下载cmake 

 下载该文件后解压，解压路径视为安装路径，可改名为cmake-3.24.0-rc3-windows-x86_64。

 添加环境变量。D:\Program Files (x86)\cmake-3.24.0-rc3-windows-x86_64\bin
 在bin目录下输入cmd，调出 cmd命令窗口。输入:cmake -version 查看版本信息确认配置成功。

3.安装vscode

win10 系统下载安装vscode，下载地址vscode

下载完成后直接安装。具体配置可参考vscode配置。

4.下载配置opencv

4.1下载软件

下载OpenCV 源文件到本地，其中版本对应为4.5.3避免新版本不稳定。

 解压到指定目录下D:\opencv， 并新建一个文件夹 D:\opencv\build\x64\mingw

 

 左下角命令窗口打开cmake-gui.exe，弹窗中首先需要确认编译目录和构建目录（上述新建）,

然后点击配置，也就是Configure，选择MinGW Makefiles：

点击finish，系统就会开始检查配置，下方的控制台会开始打印调试信息。等待结束。

结束后，cmake可能会显示一片红，此时请再次点击Configure，结束后将屏幕中仍然为红的选项勾掉，然后再配置，直到没有红色为止。

在执行完后，勾选BUILD_opencv_world，WITH_OPENGL和BUILD_EXAMPLES，不勾选WITH_IPP、WITH_MSMF和ENABLE_PRECOMPILED_HEADERS（如果有的话），CPU_DISPATCH选空。
然后点击Generate，准备生成最终的Makefile.

注意：对于上述配置过程中如果遇到 CMake编译OpenCV时opencv_ffmpeg.dll等下载失败的话，可参考这篇文档opencv_ffmpeg.dll处理参考，简单而言就是在构建目录下的CMakeDownloadLog文件中找出对应的cmake文件路径，在网页上另存为 ffmpeg_version.cmake 文件（后缀cmake,不是txt)，将此cmake文件放入 D:\opencv\build\x64\mingw\3rdparty\ffmpeg（没有ffmpeg可新建）https://raw.githubusercontent.com/opencv/opencv_3rdparty/213fcd5d4897319a83207406036c4a5957fba010/ffmpeg/ffmpeg_version.cmake

然后再次重复上述configure和generate步骤直到下载完成。

4.2 make

上述该配置的都完成了，现在需要去编译生成执行程序。在D:\opencv\build\x64\mingw 路径下进入cmd窗口，执行如下命令:

minGW32-make -j 4

如果电脑配置较好可执行 minGW32-make -j 8

4.3 install

没有出错的话，我们就继续在该目录输入命令:
minGW32-make install
这样会生成一个install目录。D:\opencv\build\x64\mingw\install

编译完成后，添加环境变量：
D:\opencv\build\x64\mingw\bin

5.vscode配置opencv

5.1配置c_cpp_properties.json

在vscode界面下，按下Ctrl+Shift+P打开vscode的内置命令块，输入C++ Configurations，找到下图这个选项：

 按下回车，vscode便会在当前工作目录生成一个.vscode文件夹，其中创建一个c_cpp_properties.json这样的配置模板文件。找到"includePath"这一项，填入正在使用的编译器的include目录即可实现配置c_cpp_properties.json如下。

{
    "configurations": [
        {
            "name": "Win32",
            "includePath": [
                "${workspaceFolder}/**",
                "D:/Program Files (x86)/mingw64/include/**",
                "D:/opencv/build/x64/mingw/install/include",
                "D:/opencv/build/x64/mingw/install/include/opencv2"
            ],
            "defines": [
                "_DEBUG",
                "UNICODE",
                "_UNICODE"
            ],
            "compilerPath": "D:\\Program Files (x86)\\mingw64\\bin\\g++.exe",
            "cStandard": "c11",
            "cppStandard": "c++11",
            "intelliSenseMode": "windows-gcc-x64"
        }
    ],
    "version": 4
}

5.2配置launch.json

在vscode 主菜单 运行/添加配置 弹出的窗口中选择gdb启动，然后配置launch.json

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "opencv4.5.3 debuge",
            "type": "cppdbg",
            "request": "launch",
            "program": "${workspaceFolder}\\${fileBasenameNoExtension}.exe",
            "args": [],
            "stopAtEntry": false,  //这里如果为 false，则说明调试直接运行。（反之则停止）
            "cwd": "${workspaceFolder}",
            "environment": [],
            "externalConsole": true, //是否调用外部cmd
            "MIMode": "gdb", 
            "miDebuggerPath": "D:/Program Files (x86)/mingw64/bin/gdb.exe",
            "setupCommands": [
                {
                    "description": "为 gdb 启用整齐打印",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": false
                }
            ],
            "preLaunchTask": "opencv4.5.3 compile task"
        }
    ]
}

5.3配置task.json

在vscode主菜单 终端（T）/配置任务  弹出窗口配置如下task.json

{
	"version": "2.0.0",
	"tasks": [
		{
			"type": "cppbuild",
			"label": "opencv4.5.3", //任务名称，要和launch.json的"preLaunchTask"字段对应
			"command": "D:\\Program Files (x86)\\mingw64\\bin\\g++.exe", //编译器路径
			"args": [
				"-g", //控制台编译时输入的-g,表示生成调试有关信息,编译生成可执行文件调试
				"-std=c++11",
        		"-fexec-charset=GBK",// 令mingw按GBK编码⽣成exe⽂件 GBK
        		"-finput-charset=UTF-8",// 令mingw按UTF-8编码处理（此参数可以不设置）//
				"${file}",//要编译的文件，默认只能编译单个文件
				"-o", //指定生成的可执行文件的名字,编译不加 -o 默认生成就是a.exe
				"${fileDirname}\\${fileBasenameNoExtension}.exe",
                "-I","D:/opencv/build/x64/mingw/install/include",
                "-I","D:/opencv/build/x64/mingw/install/include/opencv2",
				"-L","D:/opencv/build/x64/mingw/bin",
				"-l","libopencv_world453"
				
			],
			"options": {
				"cwd": "${workspaceFolder}"  //当前工作目录
			},
			"problemMatcher": [
				"$gcc"
			],
			"group": {
				"kind": "build",
				"isDefault": true // 开启编译快捷键, ctrl + shift + B
			},
			"detail": "编译器: D:\\Program Files (x86)\\mingw64\\bin\\g++.exe"
		}
	]
}

其中，-I(大写i)表示导入头文件文件夹，-L表示依赖库导入，-l（小写L）表示依赖库中dll文件的名称，dll的名称要按照下载的opencv库里的内容加以修改，libopencv_worldxxx.dll，该文件是所有依赖的集成体，不再需要一些文档里所说的一条一条添加各个独立的dll。

5.4安装code-runner插件

如果不采用上述配置方式，可安装code-runner插件，则无需上述三个文件。

                

在左侧“扩展”安装code-runner后 左下角 管理/设置 搜索code-runner将Code-runner: Executor  Map 对应settings.json中的cpp内容改为如下

"cpp": "cd $dir && g++ $fileName -o $fileNameWithoutExt -std=c++14 -I D:\\opencv\\build\\x64\\mingw\\install\\include -L D:\\opencv\\build\\x64\\mingw\\bin -l libopencv_world453 && $dir$fileNameWithoutExt",

5.5测试运行

配置完成后，新建一个cpp文件编译运行测试效果。输出窗口/ Ctrl +shift +B 编译生成exe文件，然后右上角 “ 运行C/C++程序” 对应三个配置文件的配置方式，或 Run code 对应第二种配置方式。

 

6. 其它说明

6.1命令窗口编译运行 

在终端窗口编译代码

g++ ".\openCV\example0.cpp" -o ".\openCV\example0.exe"

终端窗口提示 fatal error: opencv2/opencv.hpp: No such file or directory

这需要在终端窗口对应的编译环境下修改相关的配置如下

6.2终端窗口运行出现乱码

中文的windows下的cmd默认使用GBK的编码, 每次需要的时候只要在VSCode终端输入命令:chcp 65001, 切换代码页到使用UTF-8就可以解决中文代码的问题，如果每次修改比较麻烦。

在命令窗口powershell 下使用命令编译运行代码，若源文件含中文会出现乱码，可在文件/首选项/设置,右上角打开设置 修改setting.json后重新启动新的powershell再次运行即消除乱码。

{
    "workbench.colorTheme": "Default Dark+",
    "terminal.integrated.profiles.windows": {
        "Command Prompt": {
            "path": "C:\\Windows\\System32\\cmd.exe",
            "args": ["-NoExit", "/K", "chcp 65001"]
        },
        "PowerShell": {
            "source": "PowerShell",
            "args": ["-NoExit", "/C", "chcp 65001"]
        }
    },
    "terminal.integrated.defaultProfile.windows": "PowerShell",

    "code-runner.executorMap": {
        "javascript": "node",
        "java": "cd $dir && javac $fileName && java $fileNameWithoutExt",
        "c": "cd $dir && gcc $fileName -o $fileNameWithoutExt && $dir$fileNameWithoutExt",
        "cpp": "cd $dir && g++ $fileName -o $fileNameWithoutExt -std=c++14 -I D:/opencv/build/x64/mingw/install/include -I D:/opencv/build/x64/mingw/install/include/opencv2 -L D:/opencv/build/x64/mingw/bin -l libopencv_world453 && $dir$fileNameWithoutExt",
        "objective-c": "cd $dir && gcc -framework Cocoa $fileName -o $fileNameWithoutExt && $dir$fileNameWithoutExt",
        "php": "php",
        "python": "python -u",
        "perl": "perl",
        "perl6": "perl6",
        "ruby": "ruby",
        "go": "go run",
        "lua": "lua",
        "groovy": "groovy",
        "powershell": "powershell -ExecutionPolicy ByPass -File",
        "bat": "cmd /c",
        "shellscript": "bash",
        "fsharp": "fsi",
        "csharp": "scriptcs",
        "vbscript": "cscript //Nologo",
        "typescript": "ts-node",
        "coffeescript": "coffee",
        "scala": "scala",
        "swift": "swift",
        "julia": "julia",
        "crystal": "crystal",
        "ocaml": "ocaml",
        "r": "Rscript",
        "applescript": "osascript",
        "clojure": "lein exec",
        "haxe": "haxe --cwd $dirWithoutTrailingSlash --run $fileNameWithoutExt",
        "rust": "cd $dir && rustc $fileName && $dir$fileNameWithoutExt",
        "racket": "racket",
        "scheme": "csi -script",
        "ahk": "autohotkey",
        "autoit": "autoit3",
        "dart": "dart",
        "pascal": "cd $dir && fpc $fileName && $dir$fileNameWithoutExt",
        "d": "cd $dir && dmd $fileName && $dir$fileNameWithoutExt",
        "haskell": "runhaskell",
        "nim": "nim compile --verbosity:0 --hints:off --run",
        "lisp": "sbcl --script",
        "kit": "kitc --run",
        "v": "v run",
        "sass": "sass --style expanded",
        "scss": "scss --style expanded",
        "less": "cd $dir && lessc $fileName $fileNameWithoutExt.css",
        "FortranFreeForm": "cd $dir && gfortran $fileName -o $fileNameWithoutExt && $dir$fileNameWithoutExt",
        "fortran-modern": "cd $dir && gfortran $fileName -o $fileNameWithoutExt && $dir$fileNameWithoutExt",
        "fortran_fixed-form": "cd $dir && gfortran $fileName -o $fileNameWithoutExt && $dir$fileNameWithoutExt",
        "fortran": "cd $dir && gfortran $fileName -o $fileNameWithoutExt && $dir$fileNameWithoutExt",
        "sml": "cd $dir && sml $fileName"
    }
}