Win10 下 VSCode 安装以及 C++ 编译环境配置

正好换了一个工作地点，领了一台全新的联想电脑。正好借这个机会，将 VSCode 的完整配置过程写了一下。

完整的视频在 B 站上，可以看这个链接，https://www.bilibili.com/video/BV12k4y1r7BT/。

机器配置

操作系统：Win10

硬件：i7-9700 3.00GHz CPU + 16GB 内存。

具体如下图所示。

安装过程

安装MinGW-W64

MinGW 即 Minimalist GNU For Windows，是将 GNU 开发工具移植到 Win32 平台下的产物，是一套 Windows 上的 GNU 工具集。简单说，MinGW 是一个编译环境，相当于 linux 下的 GCC。

下载地址为：https://sourceforge.net/projects/mingw-w64/files/Toolchains%20targetting%20Win32/Personal%20Builds/mingw-builds/installer/mingw-w64-install.exe/download。

i386 对应的是 32 位系统、而 i686 是 i386 的一个子集。x86_64 主要是 64 位系统。

点击 Next，然后开始漫长的下载过程。

添加路径

点击 环境变量(N)-->单击系统变量(S) 中的Path-->单击下面的编辑-->新建-->在空格内输入上面安装MinGW后得到的bin文件的路径-->确定-->确定-->确定。如下图所示。

完成后，打开 cmd 窗口。输入 gcc，能得到如下的回复，说明你的路径已经配置成功。

安装 Python3

由于我们安装的 CodeLLDB 插件需要使用 Python3，我们需要预先安装 Python3。

Python 的官方网站为 https://www.python.org/。我们可以在这里下载最新的 Python3.8.2。

Python 下载和安装过程就跳过，这个比较简单。

安装 VSCode

下载和安装 VSCode

VSCode 官方网站为 https://code.visualstudio.com/。直接下载，然后安装即可。没有什么技术含量，就不写了。

安装插件

运行 VSCode 后，开始安装必须的插件。

安装 C/C++

如下图所示。

安装 CodeLLDB

安装了 CodeLLDB，我们可以查看 STL 的数据。如下图所示。

安装汉化插件

可以不安装

汉化插件安装后，需要关闭 VSCode，重新运行才能激活。

配置 VSCode 的 C++ 开发环境

编写一个测试程序

先简单编写一个 C++ 的 Hello 测试程序。并选择好一个路径进行保存。我的路径为 D:\zhouyi\vscode。

输入的程序代码如下。

#include <iostream>
using namespace std;
int main() {
    cout << "hello\n";
    return 0;
}

注意，下面配置的 Launch.json、Tasks.json 都会保存在 D:\zhouyi\vscode\.vscode 目录下。目录前面带个 . ，其实是 Unix 下的东西，在 Unix 环境中，这个目录将是一个隐藏的目录。

配置 Tasks.json

在主菜单中，选择 Terminal > Configure Default Build Task。如下图所示。

将出现如下界面。

如上图所示，选择 C/C++: g++.exe build active file。这样将产生如下的 json 文件。

{
	"version": "2.0.0",
	"tasks": [
		{
			"type": "shell",
			"label": "C/C++: g++.exe build active file",
			"command": "C:\\Program Files\\mingw-w64\\x86_64-8.1.0-posix-seh-rt_v6-rev0\\mingw64\\bin\\g++.exe",
			"args": [
				"-g",
				"${file}",
				"-o",
				"${fileDirname}\\${fileBasenameNoExtension}.exe"
			],
			"options": {
				"cwd": "C:\\Program Files\\mingw-w64\\x86_64-8.1.0-posix-seh-rt_v6-rev0\\mingw64\\bin"
			},
			"problemMatcher": [
				"$gcc"
			],
			"group": {
				"kind": "build",
				"isDefault": true
			}
		}
	]
}

这个脚本基本不需要进行什么修改就可以使用了。

配置 Launch.json

点击主菜单，Run > Add Configuration。出现如下图所示。

点击 Add Configuration... 后，将出现如下的界面。选择 C++ (GDB/LLDB)。

这样 VSCode 将自动产生一个 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) 启动",
            "type": "cppdbg",
            "request": "launch",
            "program": "输入程序名称，例如 ${workspaceFolder}/a.exe",
            "args": [],
            "stopAtEntry": false,
            "cwd": "${workspaceFolder}",
            "environment": [],
            "externalConsole": false,
            "MIMode": "gdb",
            "miDebuggerPath": "/path/to/gdb",
            "setupCommands": [
                {
                    "description": "为 gdb 启用整齐打印",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ]
        }
    ]
}

修改的部分：

1、增加可执行文件的名字。

修改 program 部分。改为 ${fileDirname}\\${fileBasenameNoExtension}.exe。这个的意思是

2、输出到外部窗口。

我比较喜欢输出到外部窗口，这样看起来更清楚。修改 externalConsole 部分，将数据改为 true。

3、指定 gdb 的位置。

修改 miDebuggerPath 部分。改为对应的 gdb.exe 所在路径。请参考自己安装 MinGW 路径，我的为 C:\\Program Files\\mingw-w64\\x86_64-8.1.0-posix-seh-rt_v6-rev0\\mingw64\\bin\\gdb.exe。

4、增加 preLaunchTask。

根据上面 Tasks.json 的 label 部分进行修改。

最终完成的 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) 启动",
            "type": "cppdbg",
            "request": "launch",
            "program": "${fileDirname}\\${fileBasenameNoExtension}.exe",
            "args": [],
            "stopAtEntry": false,
            "cwd": "${workspaceFolder}",
            "environment": [],
            "externalConsole": true,
            "MIMode": "gdb",
            "miDebuggerPath": "C:\\Program Files\\mingw-w64\\x86_64-8.1.0-posix-seh-rt_v6-rev0\\mingw64\\bin\\gdb.exe",
            "setupCommands": [
                {
                    "description": "为 gdb 启用整齐打印",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ],
            "preLaunchTask": "C/C++: g++.exe build active file"
        }
    ]
}

到这里，VSCode 的安装和配置已经完成。可以正常使用了。

参考资料

https://code.visualstudio.com/docs/cpp/config-mingw