VSCode配置C++环境

2023.03.31 文章有效，四舍五入就算4月份吧

win10、win11系统都可以，理论上来说。

啃生肉可以看官方教程，主要思想抄录自 B站视频

掘金的后端没那么多，但我还是发现早在21年，就已有人发了配置教程。作者说时效性不保，我来解释一下，作者发的还有用。

前置

下载 VS Code

这个……应该不需要细说吧，不会的可以看看这个老哥的帖子

建议全局安装，为计算机上的所有用户安装，插件看个人喜好，装不装中文都可以。

下载编译器 MinGW 并解压到合适的目录，作为编译环境地址

官网地址：https://www.mingw-w64.org/

下载页面：https://sourceforge.net/projects/mingw-w64/files/

向下滚动，找到 MinGW-W64 GCC-8.1.0，下载 x86_64-win32-seh

解压文件夹在自己能找得到的目录，不限制 C盘 D盘

将 MinGW/bin 文件夹添加至环境变量 path

此时可以小溜一下，在 cmd 输入 gcc -v 或者 g++ -v 看看版本号，有就是环境配好了。

VSCode插件 & 工作区的配置

下载 C/C++ 1.8.4 版本

默认下载最新版，点小齿轮，安装另一个版本，找到 1.8.4

Q：为什么是 1.8.4？

A：这个版本可以自动配置 launch 和 task，在教程结束之后，可以更新至新的版本

在工作区添加代码存放的文件夹

如果工作区存在多个文件夹，最好工作区置顶使用。不然调试的时候，很可能就先调用了上面文件夹的运行配置

新建 .c / cpp 文件，小溜一个 helloworld
F5 运行调试，以 C++ 为例
- 点击 C++ (GDB/LLDB)
- 选择 g++.exe
- 修改配置文件的部分细节
如果点错了，把 .vscode 文件夹删了重来
vscode 要在 MinGW 设置之后启动，不然找不到调试环境

F5 调试运行，或者点左侧的运行和调试，或者头顶上运行-启动调试。反正一个意思。选择 C++ (GDB/LLDB)

部分可能会有点出入，我试了好几次也不全相同，但是下面这个一定要有：

选择之后，自动生成 .vscode 配置文件夹，生成启动 launch.json

1.8.4 版本生成的齐全，之后的版本可能会少点吧

helloword 在自带终端显示，代码就算能爬了。

配置文件参考

部分编译和生成细节还需要修改，具体看下面两个 json

对应文件夹的 .vscode 配置文件夹大概如下：

launch.json：

{
    // 使用 IntelliSense 了解相关属性。 
    // 悬停以查看现有属性的描述。
    // 欲了解更多信息，请访问: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
        {
            "name": "g++.exe - 生成和调试活动文件",// 配置名称，将会在启动配置的下拉菜单中显示
            "type": "cppdbg",// 配置类型，对于 C/C++ 可认为此处只能是 cppdbg，由 cpptools 提供；不同编程语言不同
            "request": "launch",// 可以为 launch（启动）或 attach（附加）
            "program": "${fileDirname}\\debug\\${fileBasenameNoExtension}.exe",// 输出的 exe 文件放到对应目录的 debug 文件夹下，记得先创建好 debug 文件夹
            "args": [],// 程序调试时传递给程序的命令行参数，一般设为空
            "stopAtEntry": false,// 设为 true 时程序将暂停在程序入口处，相当于在 main 上打断点
            "cwd": "${fileDirname}",// 调试程序时的工作目录，{workspaceFolder} :工作区文件夹；${fileDirname} :文件所在目录
            "environment": [],// 环境变量
            "externalConsole": true,// 启动外部终端，false 则使用 vscode 自带的终端
            "MIMode": "gdb",// 指定连接的调试器，可以为 gdb 或 lldb，但我没试过 lldb
            // 直接输入 gdb.exe 也行
            "miDebuggerPath": "D:\\Aizo\\Tools\\mingw64\\bin\\gdb.exe",// gdb 的地址，mingw 文件夹的解压位置看看，系统应该会根据环境自行添加
            "setupCommands": [
                {
                    "description": "为 gdb 启用整齐打印",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                },
                {
                    "description": "将反汇编风格设置为 Intel",
                    "text": "-gdb-set disassembly-flavor intel",
                    "ignoreFailures": true
                }
            ],
            "preLaunchTask": "C/C++: g++.exe 生成活动文件"// 调试前执行的任务，一般为编译程序。与 tasks.json 的 label 相对应
        }
    ]
}

tasks.json：

{
    "tasks": [
        {
            "type": "cppbuild",
            "label": "C/C++: g++.exe 生成活动文件",// 任务名称，与 launch.json 的 preLaunchTask 相对应
            // 写 D:\\Aizo\\Tools\\mingw64\\bin\\g++.exe 这样的具体地址也行
            "command": "g++.exe",// 要使用的编译器，C++ 用 g++
            "args": [
                "-fdiagnostics-color=always",// 在伪代码的终端下，输出颜色的代码
                "-g",// 生成和调试有关的信息
                "${file}",
                "-static-libgcc",// 静态链接 libgcc，一般都会加上
                "-o",// 指定输出文件名，不加该参数则默认输出 a.exe，Linux 下默认 a.out
                "${fileDirname}\\debug\\${fileBasenameNoExtension}.exe",// 将 exe 文件收录到 debug 文件夹下，得先创建好 debug 文件夹
                "-fexec-charset=GBK"// 生成的程序使用GBK编码，不加这条会导致 Win 下输出中文乱码；繁体系统改成 BIG5
            ],// 编译的命令，其实相当于 vscode 帮你在终端中输了这些东西
            "options": {
                "cwd": "${fileDirname}"
            },
            "problemMatcher": [
                "$gcc"// 捕捉编译时终端里的报错信息到问题面板中，修改代码后需要重新编译才会再次触发
            ],
            "group": {
                "kind": "build",
                "isDefault": true// 不为 true 时 ctrl+shift+B 就要手动选择了
            },
            "detail": "调试器生成的任务。"
        }
    ],
    "version": "2.0.0"
}

到这里，环境就算配置完成了。

掘金那篇文章的作者还提供了他在工作区/文件夹的其他设置。与 cpp 无关，是 VSCode 的个性化配置。

settings.json：

{
    "files.defaultLanguage": "c", // ctrl+N新建文件后默认的语言
    "editor.formatOnType": true,  // 输入分号(C/C++的语句结束标识)后自动格式化当前这一行的代码
    "editor.suggest.snippetsPreventQuickSuggestions": false, // clangd的snippets有很多的跳转点，不用这个就必须手动触发Intellisense了
    "editor.acceptSuggestionOnEnter": "off", // 自动补全 off只有tab才会接受Intellisense，on则是回车也可以
    // "editor.snippetSuggestions": "top", // （可选）snippets显示在补全列表顶端，默认是inline

    "code-runner.runInTerminal": true, // 设置成false会在“输出”中输出，无法输入
    "code-runner.executorMap": {
        "c": "gcc '$fileName' -o '$fileNameWithoutExt.exe' -Wall -O2 -m64 -lm -static-libgcc -fexec-charset=GBK -D__USE_MINGW_ANSI_STDIO && &'./$fileNameWithoutExt.exe'",
        "cpp": "g++ '$fileName' -o '$fileNameWithoutExt.exe' -Wall -O2 -m64 -static-libgcc -fexec-charset=GBK && &'./$fileNameWithoutExt.exe'"
        // "c": "gcc $fileName -o $fileNameWithoutExt.exe -Wall -O2 -m64 -lm -static-libgcc -fexec-charset=GBK -D__USE_MINGW_ANSI_STDIO && $dir$fileNameWithoutExt.exe",
        // "cpp": "g++ $fileName -o $fileNameWithoutExt.exe -Wall -O2 -m64 -static-libgcc -fexec-charset=GBK && $dir$fileNameWithoutExt.exe"
    }, // 右键run code时运行的命令；未注释的仅适用于PowerShell（Win10默认）和pwsh，文件名中有空格也可以编译运行；注释掉的适用于cmd（win7默认）、PS和bash，但文件名中有空格时无法运行
    "code-runner.saveFileBeforeRun": true, // run code前保存
    "code-runner.preserveFocus": true,     // 若为false，run code后光标会聚焦到终端上。如果需要频繁输入数据可设为false
    "code-runner.clearPreviousOutput": false, // 每次run code前清空属于code runner的终端消息，默认false
    "code-runner.ignoreSelection": true,   // 默认为false，效果是鼠标选中一块代码后可以单独执行，但C是编译型语言，不适合这样用
    "code-runner.fileDirectoryAsCwd": true, // 将code runner终端的工作目录切换到文件目录再运行，对依赖cwd的程序产生影响；如果为false，executorMap要加cd $dir

    "C_Cpp.clang_format_sortIncludes": true, // 格式化时调整include的顺序（按字母排序），这个应该无所谓
}

酌情使用，我也没验证。毕竟对我来说，没有需求。

备注

有中文路径可能跑不起来
Windows 用户名用了中文，也可能跑不起来

跑代码的大忌啊，路径带中文。现在可能没那么限制了，但是路径不留中文是个好习惯。

找个合适的字体，VSCode 默认的中文字体是 Courier New，看着不顺眼，我改成了 DengXian（等线）

对了，记得找个能区分 1lI|0oO 的字体，斜体注释也能看得清的那种。

环境配置：（2023.04）VSCode配置C/C++环境

VSCode配置C++环境

前置

VSCode插件 & 工作区的配置

配置文件参考

备注