VSCode配置CC++环境

参考文章:挑把趁手的兵器——VSCode配置C/C++学习环境(小白向) - 知乎 (zhihu.com)

这篇文章讲的很详细,新手推荐跟着原文一起配置。

如果配置过程中出现问题,可以看一下我这篇文章中的“八、可能遇到的问题”,里面记录了我这几次安装遇到的问题以及解决方法。

一、下载mingw64

官网:MinGW-w64 - for 32 and 64 bit Windows - Browse Files at SourceForge.net

我这官网下载不了,放网盘了,可以从网盘下载。

123云盘:https://www.123pan.com/s/RbfGjv-qZzm3?提取码:ming

下载后解压,将解压后的mingw64文件夹移动到平时放软件的目录。

进入ming64目录下的bin目录,点击上方地址栏,复制地址。

image-20241015165627102

二、添加环境变量

在windows中搜索“环境变量”,点击“编辑账户的环境变量”。

image-20241015165756297

在弹出的窗口中,双击Path这一行。

image-20241015165925521

点击新建,将刚才复制的bin目录的路径粘贴过来。点击确定关毕该窗口,再次点击确定关闭上一个窗口。

image-20241015170104234

打开cmd命令提示符,输入gcc --version回车,如果出现类似下面的信息,则说明gcc安装成功。

image-20241015170444650

三、安装C/C++插件

在VS Code中搜索并下载C/C++扩展

image-20241015171402384

四、添加VS Code配置文件

在VS Code中打开存放C/C++代码的文件夹。

image-20241015170843271

在打开的文件夹(这里为C++)中创建一个新的文件夹,名称为.vscode。(不要漏了开头的"点")

再在.vscode文件夹中创建两个文件,名称为tasks.jsonlaunch.json

image-20241015171150136

分别将下面的内容粘贴到对应的两个文件中。

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程序来测试。创建文件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;
}

Ctrl+S保存后,再在hello.c所在的那个文件夹下创建一个bin文件夹。

image-20241015173052633

Ctrl+Shift+B编译文件

image-20241015173147849

五、添加快捷键(构建并运行)

点击左下角的齿轮,再点击键盘快捷方式。

image-20241015173339837

在弹出的窗口中搜索“任务”,找到“运行测试任务”这一项,双击,为其绑定快捷键。(按Esc键可以重新输入绑定的快捷键,按回车则确认绑定当前输入的快捷键)。这里设置为F4。

image-20241015173429939

绑定号快捷键后,回到hello.c文件,按下快捷键F4,hello.c就自动编译并运行了。

image-20241015173740144

六、调试

调试的配置涉及到launch.json文件。需要更改launch.json文件中的内容。

第16行中,指定了调试器的路径。

image-20241015174146376

我们需要将路径更改为我们自己电脑中的路径。还记得刚才添加环境变量的路径吗,把它复制过来,将替换掉gdb.exe前的内容。

我刚才添加环境变量时的路径是C:\Softerware\mingw64\mingw64\bin,其实也就是我mingw64的安装目录下的bin目录。
# 第16行原来的内容
"miDebuggerPath": "C:\\Program Files\\mingw64\\bin\\gdb.exe",
# 替换后(注意,防止路径被转义,需要在每一个"\"后在加上一个"\"
 "miDebuggerPath": "C:\\Softerware\\mingw64\\mingw64\\bin\\gdb.exe",
# 注意,bin后面也有两个"\\"

修改好后,保存文件,回到hello.c文件,点击代码左边的空白处,添加断点,按F5进行调试。

如果没有报错,并且出现了下面这个东西,那么恭喜你,至此C/C++环境就配置好了!

image-20241015180403726

注意:如果你在其他地方也有c项目需要再vscode中运行,需要将这个.vscode也给拷贝过去。比如你有其他的c代码在文件夹A中,那么你只需将.vscode文件夹(以及里面的两个文件)拷贝过去,就能运行正常运行了。

七、可能遇到的问题

Ctrl+Shift+B编译文件时报错。

多半是没有创建bin文件夹,或者bin文件夹和hello.c文件不在同一个文件夹下。

image-20241015184717443

调试过程中报错

下面两种情况,都是gdb路径配置错误。

image-20241015175149903

image-20241015175356838

上面这两种都是调试器gdb的路径配置错误造成的。

解决方法是:检查在launch.json文件中,第16行的路径是否配置正确,将其修改为你自己的gdb路径。

如果无法确定这个路径是否正确,可以将路径复制下来,粘贴在windows的命令行并执行,如果像下图这样,说明你的路径是正确的。

image-20241015181120255

如果是这样,那请仔细检查你的gdb路径,。

image-20241015181427303

gdb路径配置正确,但仍然报错

gdb路径配置正确,但却出现下面的提示。说明你的代码存放在一个含有中文名称的路径中。

比如我下面这个,虽然我的代码是放在C++文件夹下,不是中文。但是由于我C++文件夹是放在桌面的。“桌面”这个文件夹是中文名称,所以无法调试。

image-20241015181701510

解决方法:将代码存放在不包含中文的路径下。这里说的不包含中文,是指,从盘符根目录(比如C:或D:)开始,就没有中文。

# 这就是没有中文
E:\MyCode\C_test\C++\bin\hello.exe 
# 这就是有中文
E:\桌面\C_test\C++\bin\hello.exe 

找了好久,也没找到在中文路径下调试的方法,目前就只能将代码放在英文目录下了。

八、优化

更改配置文件

解决中文路径下无法调试的问题

解决自动创建bin文件夹,而不需要每次手动创建。