前言:
在网上看了很多教程,总来说使用 vscode 开发 c++ 项目,来编译调试程序的话,有两种方法。第一种方法是使用 json 文件来写 g++ 编译参数和 gdb 调试;第二种方法是使用手写 cmakelists.txt 来编译项目,然后使用 gdb 来调试项目,这两个命令也都可以用 json 文件实现。现主要用到方法1,方法2的话,等用到了就更新在此篇博客中。



两种方法

  • 方法1:josn 模拟 g++编译 和 gdb 调试
  • 方法2:json 模拟 cmake 编译 和 gdb 调试


方法1:josn 模拟 g++编译 和 gdb 调试

主要是以下两个 json 的配置正确即可。

tasks.json:编译.cpp文件用的命令

// 此文件主要是编译.c或.cpp多文件用的命令
{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "compile",// 与 launch.json 中的 label 要一样才能运行
            "type": "shell",// 任务类型:shell相当于先打开shell再输入命令,所以args还会经过shell再解析一遍
            "command": "gcc", // 写c用gcc;写c++用g++
            "args": [// 编译参数,shell命令
                "-g", //生成和调试有关的信息
                "${fileDirname}/*.c", //写c++把 *.c 换成 *.cpp;linux中使用 / 来分割,windows中使用 \ 来分割。
                "-o",//指定输出文件的路径和名称
                // ${fileDirname}是一个变量,表示文件所在的目录路径;${fileBasenameNoExtension}是一个变量,表示文件的基本名称(不包括扩展名)。
                "${fileDirname}/${fileBasenameNoExtension}.out",// 这里是生成可执行文件名,使用的是源文件的名字
                "-Wall", // 开启额外警告
                "-static-libgcc",   // 静态链接libgcc
                "-fexec-charset=GBK",// 生成的程序使用GBK编码,不加这一条会导致Win下输出中文乱码
                "-std=c11", // 使用c语言的标准
            ],
            "group": { //group表示‘组’,我们可以有很多的task,然后把他们放在一个‘组’里
                "kind": "build",//表示这一组任务类型是构建
                "isDefault": true//表示这个任务是当前这组任务中的默认任务
            },
            "presentation": {// 执行这个任务时的一些其他设定
                "echo": true,//表示在执行任务时在终端要有输出
                "reveal": "always",//执行任务时是否跳转到终端面板,可以为always,silent,never
                "focus": false,//设为true后可以使执行task时焦点聚集在终端,但对编译来说,设为true没有意义,因为运行的时候才涉及到输入
                //"panel": "new"//每次执行这个task时都新建一个终端面板,也可以设置为shared,共用一个面板,不过那样会出现‘任务将被终端重用’的提示,比较烦人
                "panel": "shared"
            },
            "problemMatcher": "$gcc"//捕捉编译时编译器在终端里显示的报错信息,将其显示在vscode的‘问题’面板里
        }
         // 以下代码没啥屌用,删掉就好
         //{//这个大括号里是‘运行(run)’任务,一些设置与上面的构建任务性质相同
         //   "label": "run",
         //   "type": "shell",
         //   "dependsOn": "build",//任务依赖,因为要运行必须先构建,所以执行这个任务前必须先执行build任务
         //   "command": "${fileDirname}/${fileBasenameNoExtension}",//执行exe文件,只需要指定这个exe文件在哪里就好
         //   "group": {
         //       "kind": "test",//这一组是‘测试’组,将run任务放在test组里方便我们用快捷键执行
         //       "isDefault": true
            }
        }
    ]
}

launch.json:主要用于cpp文件的调试

// 此文件主要用于.c或.cpp文件的调试
{
    "version": "0.2.0",
    "configurations": [{
        "name": "Debug", // 配置名称
        "type": "cppdbg", // 配置类型,cppdbg对应cpptools提供的调试功能;可以认为此处只能是cppdbg
        "request": "launch", // 请求配置类型,可以为launch(启动)或attach(附加)
        "program": "${fileDirname}/${fileBasenameNoExtension}",// 将要进行调试的程序的路径
        "args": [],// 程序调试时传递给程序的命令行参数,这里设为空即可
        "stopAtEntry": false,  // 设为true时程序将暂停在程序入口处,相当于在main上打断点
        "cwd": "${fileDirname}", // 调试程序时的工作目录,此处为源码文件所在目录
        "environment": [], 
        "externalConsole": false,// 为true时使用单独的cmd窗口,跳出小黑框;设为false则是用vscode的内置终端,建议用内置终端
        "internalConsoleOptions": "neverOpen",// 如果不设为neverOpen,调试时会跳到“调试控制台”选项卡,新手调试用不到
        "MIMode": "gdb", // 指定连接的调试器,gdb是minGW中的调试程序
        "miDebuggerPath": "/usr/bin/gdb", // 指定调试器所在路径,如果你的minGW装在别的地方,则要改成你自己的路径
        "preLaunchTask": "build" // 调试开始前执行的任务,我们在调试前要编译构建。与tasks.json的label相对应,名字要一样
    }]
}

方法2:json 模拟 cmake 编译 和 gdb 调试

tasks.json:cmake 编译项目用的命令

// 此文件主要是编译.c或.cpp文件用的命令
{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "build",//编译的项目名,build
            "type": "shell",
            "command": "mkdir ${fileDirname}/build;cd ${fileDirname}/build;cmake ..;make",//编译命令
            "group": {
                "kind": "build",
                "isDefault": true
            }
        },
        {
            "label": "clean",
            "type": "shell",
            "command": "make clean",
            
 
        }
    ]
}

launch.json:使用 gdb 调试编译好的可执行文件

// 此文件主要用于.c或.cpp文件的调试
{
    // Use IntelliSense to learn about possible attributes.
    // Hover to view descriptions of existing attributes.
    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
        {
            "name": "(gdb) Launch",
            "type": "cppdbg",
            "request": "launch",
            // "program": "${fileDirname}/${fileBasenameNoExtension}",
            "program": "/home/algsup/code/json/tutorial01/build/leptjson_test",
            "args": [],
            "stopAtEntry": false,
            "cwd": "${workspaceFolder}",
            "environment": [],
            "externalConsole": true,
            "MIMode": "gdb",
            "setupCommands": [
                {
                    "description": "Enable pretty-printing for gdb",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ],
            "preLaunchTask": "build",  //与tasks.json 的label项目同名
            "miDebuggerPath": "/usr/bin/gdb"
        }
    ]
}