VSCode配置C/C++环境及踩坑记录

1、下载并安装MinGW编译器

下载地址：https://sourceforge.net/projects/mingw-w64/files/Toolchains%20targetting%20Win32/Personal%20Builds/mingw-builds/installer/mingw-w64-install.exe
C/C++的编译器有很多种，大家可自行选择，笔者这里选择开源的MinGW编译器。大家可以从sourceforge的mingw项目上下载64位的编译器，直接打开进行安装，下图的笔者所选的选项。其中版本选最新版本，对语言的新特性有较好的支持；构架是32位和64位的选择，32位请选择x86；线程部分选择win32，如果是Linux请选择posix；异常模型部分选择默认的seh就好；最后一项只能选0。选好之后点击下一步。

这里要求修改路径名称，确保路径中不包含空格和中文字符，尤其是空格，因为默认位置上有空格的，一定要修改相应安装的路径。因为官方文档中要求安装路径中不能含有空格，实际上也是如此，笔者之前有过编译器的路径存在空格字符，然后配置VSCode会无法识别出路径而导致失败（就是因为路径中包含空格字符）。

这是笔者设置的安装路径。
设置好安装路径之后，点击下一步就开始安装了。因为这是在线安装的，根据网速的大小时间会有所不同。安装好之后，就是熟悉的配置环境变量步骤，如下图：

最后，打开cmd，输入gcc -v验证是否成功即可。

2、下载VScode

VSCode是一款微软出的轻量级编辑器，它本身只是一款文本编辑器而已，所有的功能都是以插件扩展的形式所存在，想用什么功能就安装对应的扩展即可，非常方便，同时也支持非常多的主题和图标，外观比较好看，重要的是VSCode支持各大主流操作系统，包括Windows、Linux和Mac OS。所以就选择它作为自己的一款主要的编辑器来使用。

（1）、下载

下载地址：https://code.visualstudio.com/
首先，我们直接去VSCode官网下载对应操作系统版本的安装包即可。因为我使用的是64位的Windows，所以下载的是64位的exe文件。此处需要注意一下，现在官网上给出了User Installer和System Installer两个安装版本，分别叫用户和系统级别的安装版本，参考官网给出的解释，区别在于安装User Installer版本不需要管理员权限，安装的位置是在用户的本地AppData目录，而System Installer的安装是需要管理员权限的，是安装在Program Files目录下的。我不清楚微软为什么要分User和System两个版本，可能是有自己的考虑吧。如果在官网首页处点击方框的下载按钮，默认下载的是User Installer版本。如果想要下载System版本的，可以点击右上角Download按钮，进而选择自己想要下载的版本。此处笔者下载的是System Installer版本。

（2）、安装

直接打开下载好的.exe文件进行安装即可。

此处选择安装位置，默认的是如图中位置，凭个人习惯即可，笔者仅将盘符改为D盘，其余保持不变。

此处是设置一些额外功能，勾选上的话，以后在文件或者目录上单击鼠标右键会出现“通过Code打开”选项，会方便使用，大家可自行选择。最后一项是默认勾选的，可以在控制台打开VSCode，建议勾选。笔者此处除了“添加到PATH”默认的勾选项外，只额外勾选了“创建桌面快捷方式”选项。


接下来就是安装过程中的信息了，最后至此已成功安装VSCode。

（3）、设置中文环境

打开VSCode后，首先是欢迎界面。可以看到，这里默认的是英文环境。

可能有人看着英文界面比较难受，下面介绍如何设置中文环境。现在中文环境也是通过安装扩展来实现，如下图，先点击侧边栏的扩展，然后在搜索框中输入language，选择“中文(简体)”进行安装，完成后重启VSCode即可。笔者这里只是实验一下步骤而已，实际使用过程中还是使用的英文界面，主要是笔者的英文水平太差，纯粹为了锻炼自己的英文习惯能力啦。

（4）、完全卸载

如果大家之前有安装过VSCode，然后只是简单卸载的话，再次安装之后，是还出现之前的配置信息，包括打开的文件夹、安装过的扩展等，这是因为之前并没有完全将VSCode卸载干净。如果想干净卸载掉VSCode再重新安装的话，就需要在卸载之后再删除掉两个目录的内容。分别是：
C:\Users$用户名.vscode
C:\Users$用户名\AppData\Roaming\Code【注】这里的“$用户名”根据自己的用户名而定。
删除掉这两个目录的内容之后，如果再安装VSCode的话，就相当于是全新安装了，即不会出现之前的相关配置信息了。

（5）、配置C/C++环境

前面已经介绍过，VSCode只是一款文本编辑器，不仅需要安装对应编程语言的扩展，还需要安装相应的编译器或者解释器。笔者这里首先需要的是C/C++的环境，所以先介绍如何配置C/C++的开发环境。如果后续笔者需要其他语言开发环境的时候，笔者再进行相应的记录并分享出来。 首先先创建一个文件夹，用来存放代码。此处建议不同的编程语言采用不同的文件夹，因为VSCode打开文件夹（称作工作目录）之后，如果进行一定的配置之后，会在该文件夹下产生一个叫".vscode"的文件夹，该文件夹中存放的是一些.json的配置文件，这些配置文件是对工作目录中的代码文件产生作用的。所以以后需要相同开发环境的时候，不用每次都去创建配置文件并进行相关配置，直接拷贝.vscode文件夹即可，但是第一次还是需要手动配置出自己所需的环境。

3、配置文件

（1）c_cpp_properties.json

可以通过Ctrl+<`快捷键打开内置终端并进行编译运行了。

{
    "configurations": [
        {
            "name": "Win32",
            "includePath": [
                "${workspaceFolder}/**"
            ],
            "defines": [
                "_DEBUG",
                "UNICODE",
                "_UNICODE"
            ],
            //此处是编译器路径，以后可直接在此修改
            "compilerPath": "D:/mingw-w64/x86_64-8.1.0-win32-seh-rt_v6-rev0/mingw64/bin/g++.exe",
            "cStandard": "c11",
            "cppStandard": "c++17",
            "intelliSenseMode": "gcc-x64"
        }
    ],
    "version": 4
}

（2）tasks.json

告诉VS Code如何构建（编译）程序

{
    // See https://go.microsoft.com/fwlink/?LinkId=733558 
    // for the documentation about the tasks.json format
    "version": "2.0.0",
    "tasks": [
        {
            "type": "shell",
            "label": "g++.exe build active file",//任务的名字，就是刚才在命令面板中选择的时候所看到的，可以自己设置
            "command": "D:/mingw-w64/x86_64-8.1.0-win32-seh-rt_v6-rev0/mingw64/bin/g++.exe",
            "args": [//编译时候的参数
                "-g",//添加gdb调试选项
                "${file}",
                "-o",//指定生成可执行文件的名称
                "${fileDirname}\\${fileBasenameNoExtension}.exe"
            ],
            "options": {
                "cwd": "D:/mingw-w64/x86_64-8.1.0-win32-seh-rt_v6-rev0/mingw64/bin"
            },
            "problemMatcher": [
                "$gcc"
            ],
            "group": {
                "kind": "build",
                "isDefault": true//表示快捷键Ctrl+Shift+B可以运行该任务
            }
        }
    ]
}

（3）launch.json

用来配置调试的相关信息

{
    // 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",
            "preLaunchTask": "g++.exe build active file",//调试前执行的任务，就是之前配置的tasks.json中的label字段
            "type": "cppdbg",//配置类型，只能为cppdbg
            "request": "launch",//请求配置类型，可以为launch（启动）或attach（附加）
            "program": "${fileDirname}\\${fileBasenameNoExtension}.exe",//调试程序的路径名称
            "args": [],//调试传递参数
            "stopAtEntry": false,
            "cwd": "${workspaceFolder}",
            "environment": [],
            "externalConsole": true,//true显示外置的控制台窗口，false显示内置终端
            "MIMode": "gdb",
            "miDebuggerPath": "D:\\mingw-w64\\x86_64-8.1.0-win32-seh-rt_v6-rev0\\mingw64\\bin\\gdb.exe",
            "setupCommands": [
                {
                    "description": "Enable pretty-printing for gdb",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ]
        }
    ]
}

4、踩坑记录

（1）使用VScode调试时报错Unable to start debugging. Unexpected GDB output from command
因为路径中有中文，全部设置为英文即无错误
（2）VSCode下，项识别为 cmdlet、函数、脚本文件或可运行程序的名称。
因为vscode下默认终端是PowerShell，改成cmd

选择后不会立即生效，显示的工具还是PowerShell，这时要关闭Vscode，然后重启就显示切换cmd，再重新运行即可成功。

5、调试代码

#include <iostream>
using namespace std;
int main()
{
    int a;
    int b;
    cin>>a>>b;
    cout << a+b << endl;
    return 0;
}

6、参考文档

https://zhuanlan.zhihu.com/p/87864677
https://blog.csdn.net/hhb442/article/details/106299337/
https://www.bbsmax.com/A/mo5kEvYMzw/