基础介绍

linux下用vscode调试c++程序时，会在工作区的.vscode文件中遇到launch.json和tasks.json，作用分别如下：

1、lauch.json负责的是启动任务，执行文件(可执行文件)

2、tasks.json负责的是配置相关任务。简单来说就是负责编译链接生成可执行文件，其实就是执行终端的编译指令[g++ -g main.cpp -o main.o]。所以在执行launch.json文件之前必须先执行tasks.json

3、launch.json和tasks.json通过launch.json中的preLaunchTask关联起来。launch.json中的preLaunchTask是为了启动tasks.json的，所以preLaunchTask对应的标签应该与task.json一致。

• 参数介绍 

launch.json

{
    "version": "2,0.0", //配置文件的版本，以前使用是0.2.0，新版本已经弃用，改用为2.0.0
    "configurations": [ //配置域
        {
            "name": "(gdb) Launch", //配置文件的名字
            "type": "cppdbg", //调试的类型,这是cpp
            "request": "launch",//配置文件的请求类型，有launch和attach两种
            "targetArchitecture": "x64", //硬件内核架构，为64bit
            "program": "${workspaceRoot}/${fileBasenameNoExtension}.out",//将要进行调试的可执行文件的路径和文件名称
            "args": [],//主函数调用时传入的参数，一般为空
            "stopAtEntry": false,//设为true时程序将暂停在程序入口处，一般设为false
            "cwd": "${workspaceFolder}",//调试时的工作目录
            "environment": [],
            "internalConsoleOptions": "openOnSessionStart",//
            "externalConsole": true,//调试时是否显示控制台窗口，一般设置为true
            "MIMode": "gdb",//指定连接的调试器，可以省略不写
            //"miDebuggerPath": "C:\\MinGW\\bin\\gdb.exe",//调试器路径,在Linux环境下需要注释掉这一行
            "setupCommands": [ 
                {
                    "description": "Enable pretty-printing for gdb",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ],
            "preLaunchTask": "build",//调试会话开始前执行的任务，一般为编译程序。与tasks.json的label相对应,一般为编译程序，c++为g++, c为gcc,采用cmake的多文件编译则为build
        }
    ]
}

tasks.json 

{
    // See https://go.microsoft.com/fwlink/?LinkId=733558
    // for the documentation about the tasks.json format
    "label": "Build", // 任务名称，与launch.json的preLaunchTask相对应
    "version": "2.0.0",
    "command": "g++",// cpp使用g++命令，c使用gcc
    "args": [ 
        "-g",
        "${file}", 
        "-o", 
        "${fileDirname}/${fileBasenameNoExtension}.out", 
        "-std=c++11",    //使用c++11
        "-lpthread"      //链接thread库
    ],
    //${fileDirname} 当前打开的文件所在的绝对路径，不包括文件名
    "problemMatcher": {
        "owner": "cpp",
        "fileLocation":  ["relative", "${workspaceRoot}"],
        "pattern": {
            "regexp": "^(.*):(\\d+):(\\d+):\\s+(warning|error):\\s+(.*)$",
            "file": 1,
            "line": 2,
            "column": 3,
            "severity": 4,
            "message": 5
        }
    }
}

${workspaceRoot} 当前打开的文件夹的绝对路径+文件夹的名字

￥{workspaceFolder}当前程序的路径，.vscode路径

${file}当前打开正在编辑的文件名，包括绝对路径，文件名，文件后缀名

${fileBasename}  当前打开的文件名+后缀名，不包括路径

${fileBasenameNoExtension} 当前打开的文件的文件名，不包括路径和后缀名

${fileDirname} 当前打开的文件所在的绝对路径，不包括文件名

${fileExtname} 当前打开的文件的后缀名

单文件调试

• 步骤

1.创建一个demo.cpp，用vscode将其所在文件夹加载进来

2.可直接按F5来调试

或者在vscode界面左边点击“运行和调试”按键 ，选择“创建launch.json”，

 选择cpp所在文件夹，此处我选择我的demo.cpp所在的code文件夹。后面的和按F5后面是一样的

3.c++选择g++，c选择gcc 

4.等待系统自动配置好后就可以进行调试了 

• launch.json和tasks.json配置

{
    // 使用 IntelliSense 了解相关属性。 
    // 悬停以查看现有属性的描述。
    // 欲了解更多信息，请访问: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
        {
            "name": "g++ - 生成和调试活动文件",
            "type": "cppdbg",
            "request": "launch",
            "program": "${fileDirname}/${fileBasenameNoExtension}",
            "args": [],
            "stopAtEntry": false,
            "cwd": "${fileDirname}",
            "environment": [],
            "externalConsole": false,
            "MIMode": "gdb",
            "setupCommands": [
                {
                    "description": "为 gdb 启用整齐打印",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ],
            "preLaunchTask": "C/C++: g++ 生成活动文件",//名字可以改成其他的，比如build，tasks.json中label下的名字要对应统一即可
            "miDebuggerPath": "/usr/bin/gdb"
        }
    ]
}

{
    "tasks": [
        {
            "type": "cppbuild",
            "label": "C/C++: g++ 生成活动文件",//名字可以改成其他的，比如build，lanuch.json中preLaunchTask下的名字要对应统一即可
            "command": "/usr/bin/g++",
            "args": [
                "-g",
                "${file}",
                "-o",
                "${fileDirname}/${fileBasenameNoExtension}"
            ],
            "options": {
                "cwd": "${fileDirname}"
            },
            "problemMatcher": [
                "$gcc"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "detail": "调试器生成的任务。"
        }
    ],
    "version": "2.0.0"
}

多文件调试

多文件调试需要使用cmake，使用编写的CMakeLists.txt来调试。

• 准备工作

1.VSCode下需要安装CMake和CMake Tools两个扩展工具。

2.采用上次CMakeLists章节的demo来演示VSCode的调试

其中add那个库现在被放在子文件夹下重新生成动态库了，3rdparty中的就没有libadd了。

• launch.json和tasks.json配置

launch.json

{
    // 使用 IntelliSense 了解相关属性。 
    // 悬停以查看现有属性的描述。
    // 欲了解更多信息，请访问: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
        {
            "name": "g++ - 生成和调试活动文件",
            "type": "cppdbg",
            "request": "launch",
            "program": "${workspaceFolder}/build/demo",//program为当前要执行程序的路径+名称，其名称由CMakeLists.txt来确定
            "args": [],
            "stopAtEntry": false,
            "cwd": "${fileDirname}",
            "environment": [],
            "externalConsole": false,
            "MIMode": "gdb",
            "setupCommands": [
                {
                    "description": "为 gdb 启用整齐打印",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ],
            "preLaunchTask": "build",
            "miDebuggerPath": "/usr/bin/gdb"
        }
    ]
}

tasks.json 

{   
    "version": "2.0.0",
    "options": {
        "cwd": "${workspaceFolder}/build"
    },
    "tasks": [
        {
            "type": "shell",
            "label": "cmake",
            "command": "cmake",
            "args": [
                ".."
            ]
        },
        {
            "label": "make",
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "command": "make",
            "args": [

            ]
        },
        {
            "label": "build",
			"dependsOrder": "sequence", // 按列出的顺序执行任务依赖项
            "dependsOn":[
                "cmake",
                "make"
            ]
        }
    ]

}

执行效果图

• 注意事项

debug的话需要在CMakeLists.txt中设置成debug模式，要不然vscode可能进不去断点。

设置debug有两种方式：

• debug模式需CMAKE_CXX_FLAGS加个-g

        set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++11 -g ")

• 使用SET(CMAKE_BUILD_TYPE Debug)

        SET(CMAKE_BUILD_TYPE Debug)