简要记录丨Windows 下 VSCode 搭建基础 C/C++ 编译环境

ゝ一纸荒年。 2022-12-27 14:30 222阅读 0赞

> 道阻且长，行则将至。埋头苦干，不鸣则已，一鸣惊人！加油，骚年！

### 文章目录 ###

*  1 参考资料
 *  2 简要说明
 *  3 正文记录
 *   *  3.1 软件安装
     *  3.2 扩展插件安装
     *  3.3 C/C++ 编译器安装
     *  3.4 VSCode C/C++ 环境配置
     *   *  3.4.1 C++ 编译环境配置
         *  3.4.2 C 编译环境配置
 *  4 编译程序测试
 *  5 总结

# 1 参考资料 #

*  Visual Studio Code 如何编写运行 C、C++ 程序？ - 谭九鼎的回答 - 知乎[（https://www.zhihu.com/question/30315894/answer/154979413）][https_www.zhihu.com_question_30315894_answer_154979413]
 *  vscode 配置 C/C++ 编译环境 教程（[https://blog.csdn.net/qq\_43041976/article/details/100542557][https_blog.csdn.net_qq_43041976_article_details_100542557]）

谢谢各位前辈的教程帮助，十分感激！

# 2 简要说明 #

首先要明白，VSCode 仅仅只是一个文本编辑器而已，类似记事本、 Sublime Text 等，本身不具备编译器的功能。

但是 VSCode 可以通过安装各种扩展插件，实现代码编译、调试、运行等功能。

我觉得首先概念要正确，然后才能好好正视这个软件，参考知乎回答解释如下：

> VSC 只是一个纯文本编辑器( editor )，不是 IDE (集成开发环境)，不含编译器( compiler )和许多其它功能，所以编译器要自己装好。

# 3 正文记录 #

## 3.1 软件安装 ##

VSCode 软件，直接去官网下载，然后傻瓜式一路 next 安装即可；

官网链接：[https://code.visualstudio.com/][https_code.visualstudio.com]

## 3.2 扩展插件安装 ##

由于参考教程，没有说必须要哪些插件，我就根据我已安装的，说一下我认为需要的插件

*  **C/C++** ：这个插件是使用 C/C++ 语言所必须的；
 *  **Code Runner** ：这个插件主要是为了更方便的运行代码；
 *  **Chinese (Simplified) Language Pack for Visual Studio Code** ：这个插件主要是为了切换软件语言为简体中文；

奉上插件截图如下，供参考

![2ddc1348f733e0a0b1643a729efe9249.png][]

## 3.3 C/C++ 编译器安装 ##

首先需要去官网下载编译器的安装包，安装版本：选最新版本中的 x86\_64-posix-seh

下载网址：[https://sourceforge.net/projects/mingw-w64/files/][https_sourceforge.net_projects_mingw-w64_files]

以我目前看到的网页，截图示例如下：

![f66e7f44d77c8d84ee9e7356fd5ce976.png][]

接下来就是编译器的安装配置过程

*  使用解压工具解压下载下来的压缩包，我使用的解压工具为：WinRAR ；我下载的文件名为：x86\_64-8.1.0-release-posix-seh-rt\_v6-rev0.7z
 *  将解压完毕后的文件夹，全部放到 C 盘，为了方便，我直接放在 C 盘下，也就是我的路径为：C:\\mingw64

![41cd32176ead9664202162e914b43690.png][]

*  接着要配置环境变量
 *  右键 “此电脑” ，选择 “属性”
 *  高级系统设置
 *  高级，环境变量
 *  可以修改当前用户的环境变量，也可以直接修改系统变量；我是修改系统变量；双击 Path 即可查看当前环境变量内容
 *  接下来可以选择 “新建” ，“浏览” 选择编译器所在路径，然后确认保存即可

![3dea6980a48ae51834681c33ae3e391a.png][]

*  C/C++ 编译器验证
 *  win + R 打开命令行，输入 cmd 运行程序，输入 gcc ，回车。此时报错是因为我们没有指定需编译的文件。如果是其他错误，那么很可能是环境变量没配置好。  
    ![8686b5510351b08494293bba576e27b0.png][]
 *  查看 gcc 版本，使用命令：gcc -v
    
    ![76c1ce3fb650df9764ab63609c884ef1.png][]
 *  需要与刚刚下载的软件版本对应

gcc version 8.1.0 (x86_64-posix-seh-rev0, Built by MinGW-W64 project)

## 3.4 VSCode C/C++ 环境配置 ##

由于区分 C/C++ ，因此两个的配置文件是不一样的。参考教程建议我们的 C C++ 程序分开存放，分别存放到两个不同的文件夹，这样可以单独配置环境。

参考我的文件夹示例如下：

![e497da5a2e59d785a43a8fef76fb20df.png][]

### 3.4.1 C++ 编译环境配置 ###

首先在 C++ 的程序文件夹下，新建一个名为`.vscode`的隐藏文件夹，然后分别新建如下三个文件

*  launch.json ，配置内容如下：

{
        
        "version": "0.2.0",
        "configurations": [{
        
            "name": "(gdb) Launch", // 配置名称，将会在启动配置的下拉菜单中显示
            "type": "cppdbg", // 配置类型，cppdbg对应cpptools提供的调试功能；可以认为此处只能是cppdbg
            "request": "launch", // 请求配置类型，可以为launch（启动）或attach（附加）
            "program": "${fileDirname}/${fileBasenameNoExtension}.exe", // 将要进行调试的程序的路径
            "args": [], // 程序调试时传递给程序的命令行参数，一般设为空即可
            "stopAtEntry": false, // 设为true时程序将暂停在程序入口处，相当于在main上打断点
            "cwd": "${workspaceFolder}", // 调试程序时的工作目录，此为工作区文件夹；改成${fileDirname}可变为文件所在目录
            "environment": [], // 环境变量
            "externalConsole": true, // 使用单独的cmd窗口，与其它IDE一致；为false时使用内置终端
            "internalConsoleOptions": "neverOpen", // 如果不设为neverOpen，调试时会跳到“调试控制台”选项卡，你应该不需要对gdb手动输命令吧？
            "MIMode": "gdb", // 指定连接的调试器，可以为gdb或lldb。但我没试过lldb
            "miDebuggerPath": "C:/mingw64/bin/gdb.exe", // 调试器路径，Windows下后缀不能省略，Linux下则不要
            "setupCommands": [
                {
         // 模板自带，好像可以更好地显示STL容器的内容，具体作用自行Google
                    "description": "Enable pretty-printing for gdb",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": false
                }
            ],
            "preLaunchTask": "Compile" // 调试会话开始前执行的任务，一般为编译程序。与tasks.json的label相对应
        }]
    }

*  settings.json ，配置内容如下：

{
        
        "files.defaultLanguage": "c++", // ctrl+N新建文件后默认的语言
        "editor.formatOnType": true,  // 输入分号(C/C++的语句结束标识)后自动格式化当前这一行的代码
        "editor.suggest.snippetsPreventQuickSuggestions": false, // clangd的snippets有很多的跳转点，不用这个就必须手动触发Intellisense了
        "editor.acceptSuggestionOnEnter": "off", // 我个人的习惯，按回车时一定是真正的换行，只有tab才会接受Intellisense
        // "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 -std=c11 -fexec-charset=GBK && &'./$fileNameWithoutExt.exe'",
            "cpp": "g++ '$fileName' -o '$fileNameWithoutExt.exe' -Wall -O2 -m64 -static-libgcc -std=c++14 -fexec-charset=GBK && &'./$fileNameWithoutExt.exe'"
            // "c": "gcc $fileName -o $fileNameWithoutExt.exe -Wall -O2 -m64 -lm -static-libgcc -std=c11 -fexec-charset=GBK && $dir$fileNameWithoutExt.exe",
            // "cpp": "g++ $fileName -o $fileNameWithoutExt.exe -Wall -O2 -m64 -static-libgcc -std=c++14 -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的顺序（按字母排序）
    }

*  tasks.json ，配置内容如下：

{
        
        "version": "2.0.0",
        "tasks": [{
        
            "label": "Compile", // 任务名称，与launch.json的preLaunchTask相对应
            "command": "g++",   // 要使用的编译器，C++用g++
            "args": [
                "${file}",
                "-o",    // 指定输出文件名，不加该参数则默认输出a.exe，Linux下默认a.out
                "${fileDirname}/${fileBasenameNoExtension}.exe",
                "-g",    // 生成和调试有关的信息
                "-m64", // 不知为何有时会生成16位应用而无法运行，加上此条可强制生成64位的
                "-Wall", // 开启额外警告
                "-static-libgcc",     // 静态链接libgcc，一般都会加上
                "-fexec-charset=GBK", // 生成的程序使用GBK编码，不加这条会导致Win下输出中文乱码；繁体系统改成BIG5
                "-std=c++14", // 要用的语言标准，根据自己的需要修改。c++可用c++14，c11
            ], // 编译的命令，其实相当于VSC帮你在终端中输了这些东西
            "type": "process", // process是把预定义变量和转义解析后直接全部传给command；shell相当于先打开shell再输入命令，所以args还会经过shell再解析一遍
            "group": {
        
                "kind": "build",
                "isDefault": true // 不为true时ctrl shift B就要手动选择了
            },
            "presentation": {
        
                "echo": true,
                "reveal": "always", // 执行任务时是否跳转到终端面板，可以为always，silent，never。具体参见VSC的文档
                "focus": false,     // 设为true后可以使执行task时焦点聚集在终端，但对编译C/C++来说，设为true没有意义
                "panel": "shared"   // 不同的文件的编译信息共享一个终端面板
            },
            "problemMatcher":"$gcc" // 捕捉编译时终端里的报错信息到问题面板中，修改代码后需要重新编译才会再次触发
            // 本来有Lint，再开problemMatcher就有双重报错，但MinGW的Lint效果实在太差了；用Clang可以注释掉
        }]
    }

### 3.4.2 C 编译环境配置 ###

同样在 C 的程序文件夹下，新建一个名为`.vscode`的隐藏文件夹，然后分别新建如下三个文件

*  launch.json ，配置内容如下：

*  settings.json ，配置内容如下：

{
        
        "files.defaultLanguage": "c", // ctrl+N新建文件后默认的语言
        "editor.formatOnType": true,  // 输入分号(C/C++的语句结束标识)后自动格式化当前这一行的代码
        "editor.suggest.snippetsPreventQuickSuggestions": false, // clangd的snippets有很多的跳转点，不用这个就必须手动触发Intellisense了
        "editor.acceptSuggestionOnEnter": "off", // 我个人的习惯，按回车时一定是真正的换行，只有tab才会接受Intellisense
        // "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 -std=c11 -fexec-charset=GBK && &'./$fileNameWithoutExt.exe'",
            "cpp": "g++ '$fileName' -o '$fileNameWithoutExt.exe' -Wall -O2 -m64 -static-libgcc -std=c++14 -fexec-charset=GBK && &'./$fileNameWithoutExt.exe'"
            // "c": "gcc $fileName -o $fileNameWithoutExt.exe -Wall -O2 -m64 -lm -static-libgcc -std=c11 -fexec-charset=GBK && $dir$fileNameWithoutExt.exe",
            // "cpp": "g++ $fileName -o $fileNameWithoutExt.exe -Wall -O2 -m64 -static-libgcc -std=c++14 -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的顺序（按字母排序）
    }

*  tasks.json ，配置内容如下：

{
        
        "version": "2.0.0",
        "tasks": [{
        
            "label": "Compile", // 任务名称，与launch.json的preLaunchTask相对应
            "command": "gcc",   // 要使用的编译器，C++用g++
            "args": [
                "${file}",
                "-o",    // 指定输出文件名，不加该参数则默认输出a.exe，Linux下默认a.out
                "${fileDirname}/${fileBasenameNoExtension}.exe",
                "-g",    // 生成和调试有关的信息
                "-m64", // 不知为何有时会生成16位应用而无法运行，加上此条可强制生成64位的
                "-Wall", // 开启额外警告
                "-static-libgcc",     // 静态链接libgcc，一般都会加上
                "-fexec-charset=GBK", // 生成的程序使用GBK编码，不加这条会导致Win下输出中文乱码；繁体系统改成BIG5
                "-std=c++14", // 要用的语言标准，根据自己的需要修改。c++可用c++14，c11
            ], // 编译的命令，其实相当于VSC帮你在终端中输了这些东西
            "type": "process", // process是把预定义变量和转义解析后直接全部传给command；shell相当于先打开shell再输入命令，所以args还会经过shell再解析一遍
            "group": {
        
                "kind": "build",
                "isDefault": true // 不为true时ctrl shift B就要手动选择了
            },
            "presentation": {
        
                "echo": true,
                "reveal": "always", // 执行任务时是否跳转到终端面板，可以为always，silent，never。具体参见VSC的文档
                "focus": false,     // 设为true后可以使执行task时焦点聚集在终端，但对编译C/C++来说，设为true没有意义
                "panel": "shared"   // 不同的文件的编译信息共享一个终端面板
            },
            "problemMatcher":"$gcc" // 捕捉编译时终端里的报错信息到问题面板中，修改代码后需要重新编译才会再次触发
            // 本来有Lint，再开problemMatcher就有双重报错，但MinGW的Lint效果实在太差了；用Clang可以注释掉
        }]
    }

# 4 编译程序测试 #

新建一个 CPP 文件，进行 C++ 编译器的测试，测试文件如下：

#include <iostream>
    
    using namespace std;
    
    int main(int argc, const char** argv) {
        
        
        std::cout << "Hello world!" << endl;
    
        getchar();	// 避免窗口一闪而过
        getchar();	// 避免窗口一闪而过
    
        return 0;
    }

测试过程，可以直接按下 F5 ，进入 **调试模式** ，也可以直接在代码中，右键，选择 **Run Code** ，进行命令行输出测试。

![6a0cbffcf8d1b4a2c50c6436c58d9f90.png][]

我直接使用 F5 ，调试输出结果如下

![5c00dd2fded0085e5a6c4f53988ee058.png][]

# 5 总结 #

整个安装过程到这里就结束啦。我原来一直觉得 VSCode 配置 C/C++ 编译环境，怎么这么麻烦，直到看到了 **谭九鼎** 前辈的那篇知乎回答，觉得很棒，把配置文件的内容讲解的十分详细，然后我就按照教程一步一步来，竟然成了！哈哈，太感谢前辈啦。

过程简要总结一下

1.  克服自己的心理抗拒，这款软件，这么多人推荐用，肯定有他好用的地方，不会说上手很难；
2.  下载好合适的 Windows 下的 C/C++ 编译器，很重要；
3.  配置好编译器的环境变量，也很重要；这样才能在全局，像使用命令行一样，使用编译器；
4.  最后就是三个配置文件，我目前的理解还是有限，但最起码成了，先做记录，随着后边深入学习了解，相信会更加熟练的！
5.  加油啊，骚年！！！

> **如果文章内容有误，麻烦评论/私信多多指教！如果觉得文章内容还不错，记得一键四连哦（点赞、收藏、留言、关注），如果您能点个关注，那就是对我最大的鼓励，也将是我创作的动力，谢谢您嘞！**

[https_www.zhihu.com_question_30315894_answer_154979413]: https://www.zhihu.com/question/30315894/answer/154979413
[https_blog.csdn.net_qq_43041976_article_details_100542557]: https://blog.csdn.net/qq_43041976/article/details/100542557
[https_code.visualstudio.com]: https://code.visualstudio.com/
[2ddc1348f733e0a0b1643a729efe9249.png]: /images/20221120/e2f11b18ae024d69acde5379178c2f39.png
[https_sourceforge.net_projects_mingw-w64_files]: https://sourceforge.net/projects/mingw-w64/files/
[f66e7f44d77c8d84ee9e7356fd5ce976.png]: /images/20221120/5d3d40af2e6d4f51b76bda7fa465cf84.png
[41cd32176ead9664202162e914b43690.png]: /images/20221120/198bdc92e0064ac082f7712e6cfc50e1.png
[3dea6980a48ae51834681c33ae3e391a.png]: /images/20221120/950cce46a8cc4cb4948f9f973e84f9e7.png
[8686b5510351b08494293bba576e27b0.png]: /images/20221120/9ff558b3930e4dafb0b39c8ff745802b.png
[76c1ce3fb650df9764ab63609c884ef1.png]: /images/20221120/5f9753553c0d4c48a52ca1e0861bb2b4.png
[e497da5a2e59d785a43a8fef76fb20df.png]: https://img-blog.csdnimg.cn/img_convert/e497da5a2e59d785a43a8fef76fb20df.png
[6a0cbffcf8d1b4a2c50c6436c58d9f90.png]: https://img-blog.csdnimg.cn/img_convert/6a0cbffcf8d1b4a2c50c6436c58d9f90.png
[5c00dd2fded0085e5a6c4f53988ee058.png]: https://img-blog.csdnimg.cn/img_convert/5c00dd2fded0085e5a6c4f53988ee058.png