1. 技术文章
  2. 简要记录丨Windows 下 VSCode 搭建基础 C/C++ 编译环境

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

由 丶灬走出姿态 提交于 2020-12-15 15:16:08

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

文章目录

1 参考资料

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

2 简要说明

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

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

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

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

3 正文记录

3.1 软件安装

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

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

3.2 扩展插件安装

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

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

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

3.3 C/C++ 编译器安装

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

  下载网址：https://sourceforge.net/projects/mingw-w64/files/

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

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

  • 使用解压工具解压下载下来的压缩包，我使用的解压工具为：WinRAR ；我下载的文件名为：x86_64-8.1.0-release-posix-seh-rt_v6-rev0.7z

  • 将解压完毕后的文件夹，全部放到 C 盘，为了方便，我直接放在 C 盘下，也就是我的路径为：C:\mingw64

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

  • C/C++ 编译器验证

  • win + R 打开命令行，输入 cmd 运行程序，输入 gcc ，回车。此时报错是因为我们没有指定需编译的文件。如果是其他错误，那么很可能是环境变量没配置好。

  • 查看 gcc 版本，使用命令：gcc -v

  • 需要与刚刚下载的软件版本对应

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

3.4 VSCode C/C++ 环境配置

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

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

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 ，配置内容如下：
{
   
   
    "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": "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 ，进行命令行输出测试。

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

5 总结

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

  过程简要总结一下

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

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

标签
gcc
Visual Studio Code
c++
next
mingw
.Net Framework
mingw-w64
sourceforge
Runner
Sublime Text
易学教程内所有资源均来自网络或用户发布的内容，如有违反法律规定的内容欢迎反馈！
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!