VSCode配置json文件 C语言篇

C文件的需要先编译 gcc -o hello hello.c 按下回车，你会发现桌面多了hello.exe文件，这说明我们成功编译生成了可执行文件，然后再在命令行中输入hello.exe运行程序 。

这样每次都用命令行太麻烦了，我们希望用更快捷的方式执行这一过程，但记事本不是专门给你写代码的，它不能提供这样的配置，但是vscode就不一样了，专门写代码的编辑器当然有专门的方式让你快捷地编译运行。这是通过.vscode文件夹下的json配置文件实现的，这些json文件怎么写是由vscode开发团队规定的（感兴趣可以去看官方的文档）

其中一个是tasks.json，task是任务的意思，我们的编译和运行就是我们想要vscode执行的任务，为此我们要在tasks.json里写两个task：Build和Run(这里为什么不是Compile呢？是因为从源码到可执行的过程中不仅是编译(Compile),还有预编译、链接等过程，用构建(Build)来表述更合适)。除了编译和运行，我们还需要进行调试(Debug)，这个就不是通过task来实现的了，而是通过launch.json文件来实现。

步骤：
在项目目录下，新建.vscode文件夹(注意前面有个.),然后在里面新建tasks.json和launch.json
tasks.json

{
    "version": "2.0.0",
    "tasks": [
        {//这个大括号里是‘构建（build）’任务
            "label": "build", //任务名称，可以更改，不过不建议改
            "type": "shell", //任务类型，process是vsc把预定义变量和转义解析后直接全部传给command；shell相当于先打开shell再输入命令，所以args还会经过shell再解析一遍
            "command": "gcc", //编译命令，这里是gcc，编译c++的话换成g++
            "args": [    //方括号里是传给gcc命令的一系列参数，用于实现一些功能
                "${file}", //指定要编译的是当前文件
                "-o", //指定输出文件的路径和名称
                "${fileDirname}\\bin\\${fileBasenameNoExtension}.exe", //承接上一步的-o，让可执行文件输出到源码文件所在的文件夹下的bin文件夹内，并且让它的名字和源码文件相同
                "-g", //生成和调试有关的信息
                "-Wall", // 开启额外警告
                "-static-libgcc",  // 静态链接libgcc
                "-fexec-charset=GBK", // 生成的程序使用GBK编码，不加这一条会导致Win下输出中文乱码
                "-std=c11", // 语言标准，可根据自己的需要进行修改，写c++要换成c++的语言标准，比如c++11
            ],
            "group": {  //group表示‘组’，我们可以有很多的task，然后把他们放在一个‘组’里
                "kind": "build",//表示这一组任务类型是构建
                "isDefault": true//表示这个任务是当前这组任务中的默认任务
            },
            "presentation": { //执行这个任务时的一些其他设定
                "echo": true,//表示在执行任务时在终端要有输出
                "reveal": "always", //执行任务时是否跳转到终端面板，可以为always，silent，never
                "focus": false, //设为true后可以使执行task时焦点聚集在终端，但对编译来说，设为true没有意义，因为运行的时候才涉及到输入
                "panel": "new" //每次执行这个task时都新建一个终端面板，也可以设置为shared，共用一个面板，不过那样会出现‘任务将被终端重用’的提示，比较烦人
            },
            "problemMatcher": "$gcc" //捕捉编译时编译器在终端里显示的报错信息，将其显示在vscode的‘问题’面板里
        },
        {//这个大括号里是‘运行(run)’任务，一些设置与上面的构建任务性质相同
            "label": "run", 
            "type": "shell", 
            "dependsOn": "build", //任务依赖，因为要运行必须先构建，所以执行这个任务前必须先执行build任务，
            "command": "${fileDirname}\\bin\\${fileBasenameNoExtension}.exe", //执行exe文件，只需要指定这个exe文件在哪里就好
            "group": {
                "kind": "test", //这一组是‘测试’组，将run任务放在test组里方便我们用快捷键执行
                "isDefault": true
            },
            "presentation": {
                "echo": true,
                "reveal": "always",
                "focus": true, //这个就设置为true了，运行任务后将焦点聚集到终端，方便进行输入
                "panel": "new"
            }
        }

    ]
}

launch.json

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

测试
hello.c中输入如下代码：

#include <stdio.h>
int main()
{
    char name[10];
    printf("Input your name: ");
    scanf("%s",name);
    printf("Hello,%s,this is your vscode!\n",name);
    return 0;
}

项目目录下建一个bin文件夹

仅编译（构建），用快捷键ctrl+shift+B，没有报错，bin文件夹下多了hello.exe，编译成功！

编译（构建）+运行，测试任务默认没有快捷键，我们自己绑定一个：点击左下角小齿轮->键盘快捷方式->搜索任务->找到运行测试任务,点击左侧加号添加键绑定，这里我们设为F4，然后回到我们的hello程序页面，按下F4，输入你的名字，按下回车，运行成功！

接下来是调试（vscode的调试功能非常直观易用，你会爱上它的），在第一个printf处打上断点（点击行号前面的小红点，或者用快捷键F9)，然后打开左侧的运行面板，点击绿色小三角开始调试（或者直接用调试快捷键F5）

我们使用单步调试按钮，快捷键F11,单步向下执行程序，黄色箭头所指示行是现在未执行、下一步将要执行的语句，当执行到输入语句时，黄色箭头会消失，这时你在终端面板内进行输入，然后按回车，黄色箭头重新出现，可以继续向下执行。

调试成功！

可能出现的问题

• 中文乱码

乱码问题是由于文件编码格式引起的，vscode默认的编码格式是UTF-8，而Windows的终端的默认编码是GBK，这就造成了中文会显示成乱码，解决办法是生成程序时指定用GBK，我们的task里已经指定了，所以理论上你不应该出现这个问题

• 找不到头文件

正确添加了环境变量的话，不应该出现这个问题

• “终端将被任务重用，按任意键关闭终端”

按照我们在task中的设置，每次执行一个task就会打开一个新的终端面板。
如果你把task的"panle"属性改成了"shared",所有的任务都用的这一个终端，vscode会提醒你“终端将被任务重用”，这句话并不是报错，只是提醒，你无视它就好，而且在设置里还可以关闭这句提醒。

简单的多文件程序

我们已经搞定了C_Single，多文件的C_Multiple的设置也类似，只需要改一下那两个配置文件涉及到路径的部分，文件如下，你可以对比一下：

多文件tasks.json

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "build",
            "type": "shell",
            "command": "gcc", //写c++换成g++
            "args": [
                "${fileDirname}\\*.c", //写c++把 *.c 换成 *.cpp
                "-o",
                "${fileDirname}\\${fileBasenameNoExtension}.exe",
                "-g",
                "-Wall", 
                "-static-libgcc",   
                "-fexec-charset=GBK",
                "-std=c11",  //写c++换成c++标准
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "presentation": {
                "echo": true,
                "reveal": "always",
                "focus": false,
                "panel": "new"
            },
            "problemMatcher": "$gcc"
        },
        {
            "label": "run",
            "type": "shell",
            "dependsOn": "build",
            "command": "${fileDirname}\\${fileBasenameNoExtension}.exe",
            "group": {
                "kind": "test",
                "isDefault": true
            },
            "presentation": {
                "echo": true,
                "reveal": "always",
                "focus": true,
                "panel": "new"
            }
        }

    ]
}

多文件launch.json

{
    "version": "0.2.0",
    "configurations": [{
        "name": "Debug", 
        "type": "cppdbg", 
        "request": "launch",
        "program": "${fileDirname}\\${fileBasenameNoExtension}.exe",
        "args": [],
        "stopAtEntry": false, 
        "cwd": "${fileDirname}", 
        "environment": [], 
        "externalConsole": false,
        "internalConsoleOptions": "neverOpen",
        "MIMode": "gdb", 
        "miDebuggerPath": "C:\\Program Files\\mingw64\\bin\\gdb.exe", 
        "preLaunchTask": "build" 
    }]
}

资料来源：
https://zhuanlan.zhihu.com/p/147366852