Vscode C++Debug环境配置（WSL）

单文件debug

概要

本文介绍vscode c++ debug环境三个文件的配置方法，配置完毕即可打断点调试开发。

c_cpp_properties.json

C\C++编译环境配置
按下ctrl+shift+p，选C/C++:Edit Configuration UI,生成c_cpp_properties.json,一般保持默认的设置不变即可。

task.json

编译配置
按下ctrl+shift+p，选Tasks: Configure Default Build Task,生成task.json,做以下修改：

{
	"version": "2.0.0",
	"tasks": [
		{
			"type": "shell",//原本是cppbuild,不改成shell的话可以单独执行task，但
							//但无法把task作为launch的先导任务
			"label": "Build",//把这个很长的名字改成Build，便于填写，也可以不改
			"command": "/usr/bin/g++-11",
			"args": [
				"-fdiagnostics-color=always",
				"-g",
				"${file}",
				"-o",
				"${fileDirname}/${fileBasenameNoExtension}"
			],
			"options": {
				"cwd": "./${fileDirname}"
			},
			"problemMatcher": [
				"$gcc"
			],
			"group": {
				"kind": "build",
				"isDefault": true
			},
			"detail": "编译器: /usr/bin/g++-11",
			"presentation":{
				"panel":"new"
			},//增加presetation属性，设置打开新panel，防止出现终端被占用的报错
			
		}
	]
}

launch.json

调试配置

点击debug图标

生成launch.json文件以后，文件里面有Add Configuration按钮，点击，选C/C++: (gdb) Launch,会生成很多默认配置，做如下修改：

{
    // 使用 IntelliSense 了解相关属性。 
    // 悬停以查看现有属性的描述。
    // 欲了解更多信息，请访问: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
        {
            "name": "(gdb) 启动",
            "type": "cppdbg",
            "request": "launch",
            "program": "${fileDirname}/${fileBasenameNoExtension}",//和task中生成的
            													   //文件保持一致
            "args": [
                "./images/1.png"
            ],//这里是调试的时候想传入的参数
            "stopAtEntry": false,
            "cwd": "${fileDirname}",
            "environment": [],
            "externalConsole": false,
            "MIMode": "gdb",
            "preLaunchTask": "Build",//改为task中的label，这样可以每次调试之前重新编译
            "setupCommands": [
                {
                    "description": "为 gdb 启用整齐打印",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                },
                {
                    "description": "将反汇编风格设置为 Intel",
                    "text": "-gdb-set disassembly-flavor intel",
                    "ignoreFailures": true
                }
            ]
        }
    ]
}

测试

按F5调试

以上只是我摸索出的一种可以调试的配置方式，更多vscode的配置文件用法还有待探索。

Cmake链接多文件编译并debug

以ncnn工程为例，源码根目录下有一个CMakeLists.txt文件，在已经安装cmake、cmaketools两个插件以后会自动识别该cmake工程，可点击下面这个图标查看：

在根目录新建一个build文件夹，这样build时会将生成的文件自动放入该文件夹中，点击build all projects：

耗时相当长，这是因为该过程不光编译了example中几个示例项目（yolo，yolact等），还要生成这些项目所依赖的库和头文件等。如果对yolact示例代码做修改并调试，需要执行clean rebuild all projects，又要重新生成一遍库和头文件，这样非常耗时，调试起来极为不便。

实际上，可以重新创建一个cmake工程，用vscode重新、单独把这个工程打开。工程包含：需要调试或者编译的代码，一个CMakeLists.txt文件，一个空的build文件夹。CMakeLists.txt指向之前编译成功地库和头文件，就不需要重复编译。

ncnn编译完成以后生成的库和头文件位置在ncnn/build/install，如下

如果要调试yolact.cpp,CMakeLists.txt文件可这样写：

cmake_minimum_required(VERSION 3.5)
find_package(OpenCV REQUIRED core highgui imgproc)

include_directories(/proj/ncnn/build/install/include/ncnn) # 这里指定编译生成的头文件位置
link_directories(/proj/ncnn/build/install/lib) # 这里指定编译生成的库文件位置

FIND_PACKAGE( OpenMP REQUIRED)  
if(OPENMP_FOUND)  
    message("OPENMP FOUND")  
    set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} ${OpenMP_C_FLAGS}")  
    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} ${OpenMP_CXX_FLAGS}")  
    set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} ${OpenMP_EXE_LINKER_FLAGS}")  
endif()  

add_executable(main yolact.cpp)

target_link_libraries(main ncnn ${OpenCV_LIBS}) # 指定生成的可执行文件名为main

接着设置编译任务，不同于上面介绍的使用g++编译，此处要选cmake build，即按下ctrl shift p,选Tasks: Configure Default Build Task ，然后选CMake:build,使用默认生成的task.json即可。

最后设置调试配置文件，也就是launch.json，还是从add configuration里面选择gdb launch,将program改成生成的可执行文件的位置就行，比如

"program": "${workspaceFolder}/build/main",

设置先导任务为task.json中的label,这样就可以每次调试之前都重新编译，即：

"preLaunchTask": "CMake: build",

然后就可以在cpp代码打断点进行调试。