VSCode配置C++开发环境（MinGW-w64）

最近在学习C++的相关知识，这就需要配置相关的开发环境，虽然Visual Studio可以近乎“傻瓜式”安装相应的开发环境，但是其占用量也非常大，VSCode相对轻量化，也方便后面学习其他语言的开发。

在VSCode配置C++开发环境的过程中，我也踩了许多的坑，记录一下，也为有需要的同学提供参考。

1、VSCode下载安装

VSCode下载安装其实很简单，但是大家需要注意“VSCode收费”的情况。VSCode本身是免费的，所以下载的时候要从官方网站下载，这边贴一下官方网站：https://code.visualstudio.com/

下载好安装包只需要双击安装即可，如果有需要的话，可以调整安装位置，个人建议别占用C盘空间。

2、MinGW-w64下载、安装与配置

（1）下载安装

MinGW-w64的下载依旧建议从官网下载：https://sourceforge.net/projects/mingw-w64/files/
安装过程中，一定要记住自己的安装路径，因为后面配置系统环境变量的时候需要用到！

需要注意的是，MinGW-w64有两种安装方式：

• 一种是安装器的形式，即从官网下载一个exe文件，然后双击运行，接着通过这个安装器选择想要的版本等信息，最后安装器根据我们的选择从官网下载安装对应的版本。这种方式虽然简单，但是很大概率会因为网络原因安装失败，所以非常不推荐！！！
• 另一种是从官网下载我们需要的版本的压缩包，然后本地解压即可。其实这种方式也不复杂，不过需要我们对其中的几个参数有一定的了解。这边附一张官网的图，方便大家了解这两种方式的区别，也避免下载错误。

x86_64是指64位的操作系统，i686是指32位的操作系统；

win32是开发windows系统程序的协议，posix是其他系统的协议（例如Linux、Unix、Mac OS）；

异常处理模型 seh（新的，仅支持64位系统），sjlj （稳定的，64位和32位都支持）， dwarf （优于sjlj的，仅支持32位系统）。

本人使用的系统是64位Win10系统，使用版本为x86_64-win32-seh。 据说x86_64-win32-sjlj的版本也可以，但是我在实际使用过程中，使用string类型的时候，没法正常使用，一旦定义一个string类型变量，编译运行之后终端就会“闪一下退出”如果直接使用终端命令编译运行是可以的；我的解决方式就是更改版本为x86_64-win32-seh，问题解决。

（2）环境变量配置

鼠标放置在“此电脑”上，右击选择“属性”，一直滑到最下面，选择“高级系统设置”，然后选择“环境变量”

然后在“系统变量”中选择“新建”

然后输入“变量名”和“变量值”，建议变量名和我的一模一样，变量值设置为自己的安装路径。（该路径应该是bin目录的上一级）

然后在“系统变量”中找到“Path”，双击或者点击“编辑”

进入编辑页之后，点击“新建”，然后在最后添加一行和我一样的路径即可。千万记得点击“确认” 进行保存！！！

（3）验证

键盘按Win+R键，然后输入cmd，按“确定”或者“回车”

在终端中输入gcc -v，然后回车，如果可以输出一堆东西，并且最后有一个gcc的版本信息，那就说明安装配置成功了。

3、VSCode配置C++开发环境

（1）插件安装

打开安装好的VSCode，选择左侧的“拓展”，选择安装“C/C++”，这个是必须要安装的。如果你和我一样，英文非常菜，你也可以安装简体中文的拓展，这样VSCode就会编程中文的，这就非常的友好。建议安装完拓展之后重启一下VSCode。

（2）配置文件

接下来是非常非常重要的部分，也是非常容易出错的部分，有的同学可能会遇到一些莫名其妙的问题，我尝试了好长时间，看了很多前辈的帖子，目前我的这个配置没有问题，但是确实没法保证针对其他开发环境也百分百有用，如果有问题，可以交流！

首先创建一个工作区（新建一个文件夹用于后面存放代码等文件），我这儿名称叫“CPLUSPLUS”，然后在这个工作区里面新建一个“.vscode”的文件夹，注意不是“vscode”，不要漏掉那个点，接着在这个文件夹里面新建三个配置文件“c_cpp_properties.json”、“launch.json”、“tasks.json”。

c_cpp_properties.json文件

{
    "configurations": [
        {
            "name": "Win32",
            "includePath": [
                "${workspaceRoot}",
                "D:/mingw64/include/**",
                "D:/mingw64/bin/../lib/gcc/x86_64-w64-mingw32/8.1.0/include/c++",
                "D:/mingw64/bin/../lib/gcc/x86_64-w64-mingw32/8.1.0/include/c++/x86_64-w64-mingw32",
                "D:/mingw64/bin/../lib/gcc/x86_64-w64-mingw32/8.1.0/include/c++/backward",
                "D:/mingw64/bin/../lib/gcc/x86_64-w64-mingw32/8.1.0/include",
                "D:/mingw64/bin/../lib/gcc/x86_64-w64-mingw32/8.1.0/include-fixed",
                "D:/mingw64/bin/../lib/gcc/x86_64-w64-mingw32/8.1.0/../../../../x86_64-w64-mingw32/include"
            ],
            "defines": [
                "_DEBUG",
                "UNICODE",
                "__GNUC__=6",
                "__cdecl=__attribute__((__cdecl__))"
            ],
            "compilerPath": "D:/mingw64/bin/g++.exe",
            "intelliSenseMode": "windows-gcc-x64",
            "browse": {
                "limitSymbolsToIncludedHeaders": true,
                "databaseFilename": "",
                "path": [
                    "${workspaceRoot}",
                     "D:/mingw64/include/**",
                     "D:/mingw64/bin/../lib/gcc/x86_64-w64-mingw32/8.1.0/include/c++",
                     "D:/mingw64/bin/../lib/gcc/x86_64-w64-mingw32/8.1.0/include/c++/x86_64-w64-mingw32",
                     "D:/mingw64/bin/../lib/gcc/x86_64-w64-mingw32/8.1.0/include/c++/backward",
                     "D:/mingw64/bin/../lib/gcc/x86_64-w64-mingw32/8.1.0/include",
                     "D:/mingw64/bin/../lib/gcc/x86_64-w64-mingw32/8.1.0/include-fixed",
                     "D:/mingw64/bin/../lib/gcc/x86_64-w64-mingw32/8.1.0/../../../../x86_64-w64-mingw32/include"
                ]
            }
        }
    ],
    "version": 4
}

关于c_cpp_properties.json，需要修改的是“includePath”和“path”。至于这里面六个路径分别是什么，大家可以使用命令行去查询自己的对应路径。依然是Win+R，然后输入cmd，接着回车，然后在终端输入下面的命令，接着回车即可。

gcc -v -E -x c++ -

launch.json文件

{  
    "version": "0.2.0",  
    "configurations": [  
        {  
            "name": "(gdb) Launch", // 配置名称，将会在启动配置的下拉菜单中显示  
            "type": "cppdbg",       // 配置类型，这里只能为cppdbg  
            "request": "launch",    // 请求配置类型，可以为launch（启动）或attach（附加）  
            "program": "${workspaceFolder}/exe/${fileBasenameNoExtension}.exe",// 将要进行调试的程序的路径  
            "args": [],             // 程序调试时传递给程序的命令行参数，一般设为空即可  
            "stopAtEntry": false,   // 设为true时程序将暂停在程序入口处，一般设置为false  
            "cwd": "${workspaceFolder}", // 调试程序时的工作目录，一般为${workspaceFolder}即代码所在目录  
            "environment": [],  
            "externalConsole": true, // 调试时是否显示控制台窗口，一般设置为true显示控制台  
            "MIMode": "gdb",  
 
 
            // 这里的路径需要修改。改成自己的路径
            "miDebuggerPath": "D:/mingw64/bin/gdb.exe",
 
            "preLaunchTask": "C/C++: g++.exe 生成活动文件", // 调试会话开始前执行的任务，一般为编译程序，c++为g++, c为gcc  
            "setupCommands": [  
                {   
		            "description": "Enable pretty-printing for gdb",  
                    "text": "-enable-pretty-printing",  
                    "ignoreFailures": true  
                }  
            ]  
        }  
    ]  
}

需要注意的是参数“program”中我让编译生成的“exe文件”单独放在一个文件夹里面了，这样代码文件和编译生成的“exe文件”可以区分开，更加的有条理。参数“miDebuggerPath”修改为自己的路径即可。参数“preLaunchTask”需要注意一下，这个参数需要和后面的task.json文件中的一个参数对应（两者一模一样）。

task.json文件

{
    "version": "2.0.0",
    "tasks": [
        {
            "type": "shell",
            "label": "C/C++: g++.exe 生成活动文件",//任务的名字，就是刚才在命令面板中选择的时候所看到的，可以自己设置
            "command": "D:/mingw64/bin/x86_64-w64-mingw32-g++.exe",
            "args": [//编译时候的参数
                "-g",//添加gdb调试选项
                "${file}",
                "-o",//指定生成可执行文件的名称
                "${workspaceFolder}/exe/${fileBasenameNoExtension}.exe"
            ],
            "options": {
                "cwd": "D:/mingw64/bin"
            },
            "problemMatcher": {
                "owner": "cpp",
                "fileLocation": [
                    "relative",
                    "\"
                ],
                "pattern": {
                    "regexp": "^(.*):(\d+):(\d+):\s+(warning|error):\s+(.*)$",
                    "file": 1,
                    "line": 2,
                    "column": 3,
                    "severity": 4,
                    "message": 5
                }
            },
            "group": {
                "kind": "build",
                "isDefault": true//表示快捷键Ctrl+Shift+B可以运行该任务
            }
        }
    ]
}

前文说到的launch.json文件中的“preLaunchTask”参数要和task.json文件中的“label”参数保持一致。“command”参数和“cwd”参数修改为自己对应的路径即可。

（3）测试

新建一个专门存放代码文件的文件夹（自定义名称），然后新建一个名为exe的文件夹用于存放编译产生的exe文件，接着在新建的存在代码的文件夹中新建一个后缀为cpp文件，并输入测试代码

按“F5”键编译运行，会发现终端自动跳出，并显示内容，同时exe文件夹中有一个新生成的文件，这就是编译后的exe文件。

（4）中文乱码问题解决

上述测试过程中，我们会发现终端的输出内容看不懂，是一串乱码

这是因为VSCode使用的是“UTF-8”编码，而Win10终端默认的是使用gbk编码，我们当然可以修改终端的默认编码格式来解决中文乱码问题，但是后面其他的工作场景可能会带来一些意想不到的问题，因此我们采用的是“将VSCode的编码修改为gbk”

点击左下角“齿轮”形状的“设置”，选择“设置”，进入设置页之后，输入并搜索“编码”，然后将“UTF-8”编码修改为“Simplified Chinese (GB 2312)”，然后重新F5运行即可。

综上就完成了VSCode配置C++开发环境的过程了。