MENU

VSCode 配置C/C++开发环境

• March 26, 2020 • Read: 5230 • 解决方案,知识库

1. 环境的准备展开目录

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

下载编译器展开目录

MinGW-w64 - for 32 and 64 bit Windows 往下稍微翻一下，选最新版本中的 x86_64-posix-seh。

安装编译器展开目录

下下来的是一个 7z 的压缩包。看好 bin 文件夹的完整路径，我的是 C:\mingw64\bin，把它加到环境变量中的 PATH 里去。如果你不会这一步，请百度 “如何添加环境变量” Debian 系 Linux 用 sudo apt update; sudo apt install build-essential 即可。顺序不重要；路径可以不一样，反正保证 gcc.exe 在那个文件夹里就行验证按 Win+R，运行 cmd（不要跳这一步），输入 gcc，应该会提示 no input files 而不是 “不是内部命令或外部命令” 或者 “无法将 "gcc" 项识别为 cmdlet、函数、脚本文件或可运行程序的名称”。
如果是 “不是内部命令或外部命令”，说明 gcc 在的文件夹没有在环境变量的 Path 中，要加进去才行。如果加了还是这样，重启。如果重启了还不行，那就是你自己进行的操作有问题。输 gcc -v 可以显示出 gcc 的版本。如果显示出来的版本与你刚下的不同 / 更老，说明 Path 里原本有老版本的编译器，可能是安装其它 IDE 时装上的。则需要去掉 Path 里原来的那一个 gcc 的路径。这两项验证一定要符合，否则必须修改环境变量。小心别错删了。
输入 gcc -v 的最后一行输出。版本要和你自己下的对应，例如 64 位要有 x86_64 和 seh 安装扩展 (extension) C/C++：又名 cpptools，提供 Debug 和 Format 功能 Code Runner：右键即可编译运行单文件，很方便，但无法 Dubug。

其他可选扩展：展开目录

1.Bracket Pair Colorizer
2.One Dark Pro：大概是 VS Code 安装量最高的主题

不建议 / 不需要装的扩展：展开目录

1.GBKtoUTF8：把 GBK 编码的文档转换成 UTF8 编码的。此扩展很久没有更新了，可能有严重的 bug。
2.C++ Intellisense：用的是 gtags，效果非常非常一般。
3.Include Autocomplete：提供头文件名字的补全，现在 cpptools 和 vscode-clangd 都已经自带这个功能了，所以不用装。
4.C/C++ Snippets：Snippets 即重用代码块，效果自己百度；这个扩展安装量虽高，不过个人感觉用处实在不大，cpptools 和 clangd 也自带一些。

补充内容：展开目录

  • 你也可以选择其他的 Snippets 扩展甚至自己定义补充知识编译器是把源代码变成可执行文件的，编辑器是你打字的软件。记事本就是一个编辑器，VSC 也是编辑器。编辑器是无法编译运行程序的，因为那是编译器的工作。
  • MinGW 是 gcc 在 Windows 下的移植，gcc 是世界上最流行的 C/C++ 编译器组合。但 gcc 这个名字也指编译 C 语言的那个程序，g++ 才是 C++ 编译器。即 gcc 程序和 g++ 程序包含在 gcc 套件以及 MinGW 里，当只说 gcc 时要根据语境自己区分。
  • 其实 MinGW 和 MinGW-w64 只是名字像，它们是两个不同的项目。为了方便，本文中的 MinGW 指的其实都是 MinGW-w64。MinGW 本身已经很久没有更新了，不使用它哎呀，原来 MinGW 是活着的，但它只能产生 32 位程序。
  • 扩展是 extension，插件是 plugin，VSC 用的是前者这种称呼。大部分文章都是混用两者的，不严谨但是能理解就行，要学会抓主要矛盾。

2. 配置.json 文件展开目录

创建一个你打算存放代码的文件夹，称作工作区文件夹；路径不能含有中文和引号，最好不要有空格，我用的是 C:\VSCode-C。C 和 C++ 需要分别建立不同的文件夹，除非用虚拟工作区。不要选上一段建出来的文件夹，源代码和编译器要分开放。打开 VSC，选打开文件夹；最好不要选 “添加工作区文件夹”，这个就是虚拟工作区，我没用过，不保证没问题。点新建文件夹，名称为.vscode。不在资源管理里新建的原因是 Windows 的 Explorer 不允许创建的文件夹第一个字符是点（1903 后才支持）。然后创建 launch.json，tasks.json，settings.json（不是 setting.json） 放到.vscode 文件夹下。
一定要在.vscode 里，别变成平行的了，这几个文件的内容见下。复制以下代码出来后，知乎会自动在前面加上几行保留所有权利的字，实际使用的时候肯定要删了的。有些地方可选修改，自己对照着注释看吧。注意：如果是写 C++，tasks.json 的一个地方必须要修改。

launch.json 代码展开目录

externalConsole 可根据自己喜好修改；cwd 可以是程序运行时的相对路径，如有需要可以改为 ${fileDirname}。type 和 request 不变色是正常现象。

  • // https://github.com/Microsoft/vscode-cpptools/blob/master/launch.md

  • {

  •     "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, // 为true时使用单独的cmd窗口，与其它IDE一致；18年10月后设为false可调用VSC内置终端

  •         "internalConsoleOptions": "neverOpen", // 如果不设为neverOpen，调试时会跳到“调试控制台”选项卡，你应该不需要对gdb手动输命令吧？

  •         "MIMode": "gdb", // 指定连接的调试器，可以为gdb或lldb。但我没试过lldb

  •         "miDebuggerPath": "gdb.exe", // 调试器路径，Windows下后缀不能省略，Linux下则不要

  •         "setupCommands": [

  •             { // 模板自带，好像可以更好地显示STL容器的内容，具体作用自行Google

  •                 "description": "Enable pretty-printing for gdb",

  •                 "text": "-enable-pretty-printing",

  •                 "ignoreFailures": false

  •             }

  •         ],

  •         "preLaunchTask": "Compile" // 调试会话开始前执行的任务，一般为编译程序。与tasks.json的label相对应

  •     }]

  • }

tasks.json 代码展开目录

如果是编写 C++，编译器需改成 g++；如果不想要额外警告，把 - Wall 那一条删去；-std 根据自己需要修改；Linux 下不需要加 - fexec-charset。反正这些我都加了注释，还看不懂，百度 gcc 使用教程。reveal 控制编译时是否跳转到终端面板。可根据自己喜好修改；即使设为 never，也只是不自动跳转，手动点进去还是可以看到信息。

  • // https://code.visualstudio.com/docs/editor/tasks

  • {

  •     "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",    // 生成和调试有关的信息

  •             "-Wall", // 开启额外警告

  •             "-static-libgcc",     // 静态链接libgcc，一般都会加上

  •             "-fexec-charset=GBK", // 生成的程序使用GBK编码，不加这一条会导致Win下输出中文乱码

  •             // "-std=c11", // C++最新标准为c++17，或根据自己的需要进行修改

  •         ], // 编译的命令，其实相当于VSC帮你在终端中输了这些东西

  •         "type": "process", // process是vsc把预定义变量和转义解析后直接全部传给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，再开这个可能有双重报错

  •     }]

  • }

settings.json 代码展开目录

把这个文件里的东西放到 “用户设置” 里可以覆盖全局设置，否则只在当前工作区才有效。这两点各有自己的优势。Code Runner 的命令行和某些选项可以根据自己的需要在此处修改，想自定义或者想知道是什么意思还是参见此扩展的文档和百度 gcc 使用教程。如果终端用的是 cmd（Win7 默认）需要改用注释掉的，或者把 terminal.integrated.shell.windows 改为 PowerShell；Win10 默认就是 PS 就不用改。

  • {

  •     "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": "cd $dir && gcc '$fileName' -o '$fileNameWithoutExt.exe' -Wall -g -O2 -static-libgcc -std=c11 -fexec-charset=GBK && &'$dir$fileNameWithoutExt'",

  •         "cpp": "cd $dir && g++ '$fileName' -o '$fileNameWithoutExt.exe' -Wall -g -O2 -static-libgcc -std=c++17 -fexec-charset=GBK && &'$dir$fileNameWithoutExt'"

  •         // "c": "cd $dir && gcc $fileName -o $fileNameWithoutExt.exe -Wall -g -O2 -static-libgcc -std=c11 -fexec-charset=GBK && $dir$fileNameWithoutExt",

  •         // "cpp": "cd $dir && g++ $fileName -o $fileNameWithoutExt.exe -Wall -g -O2 -static-libgcc -std=c++17 -fexec-charset=GBK && $dir$fileNameWithoutExt"

  •     }, // 右键run code时运行的命令；未注释的仅适用于PowerShell（Win10默认），文件名中有空格也可以编译运行；注释掉的适用于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是编译型语言，不适合这样用

  • 

  •     "C_Cpp.clang_format_sortIncludes": true, // 格式化时调整include的顺序（按字母排序）

  • }

3. 写代码，编译，调试展开目录

建文件后就可以写代码了，c 语言源代码后缀是.c，c++ 是.cpp 或.C 或.cxx（这也要我教吗……）。代码文件在保存工作区内都可以，可以自己建立文件夹，不必放到.vscode 文件夹里，但路径里 (包括文件名) 不要含有中文和引号，最好不要有空格。
按 Alt+Shift+F（或者用右键菜单）可以格式化代码，出现 Intellisense 的时候按 tab 可以补全代码。打出 snippets 时会出现多个跳转点，按 tab 可以跳到下一个去。
停止输入一小段时间（一秒）后就会有 Lint，扩展会给一些建议性的 warning（比如声明了变量但不使用），自己清楚就行。如果觉得不爽，也有方法不让它提示，比如去掉 - Wall 就会少一些。如果还想去掉更多的警告，我提示一下：-Wno-...。找好参数后可以用#pragma GCC diagnostic ignored 或者加到各种 Flags 里。
按 Ctrl+Shift+B 单纯编译，按 F5 为编译加调试；本来 ctrl+F5 为运行但不调试，但现在 cpptools 暂不支持，还是会调试。
在写程序初期，我强烈建议不要把 f5 当作编译来使用，因为有的 bug 只会产生警告，不会阻止编译，但这些东西越早期解决越好。编译信息会在底下的 “终端” 面板里，如果代码有错误，点进去可以看编译器报的信息；不过因为有 Lint 了，平常的错误可以马上被发现和修改，写代码就轻松很多。
加断点在列号前面点一下就行，右键可以加条件断点。如果想从一开始就停下来，可以加在 main 函数那里，或者 launch.json 中有个设置。开始调试后，按 f11 可以一步一步进行，箭头所指的那行代码就是下一步要运行的代码；f5 是一直运行到下一个断点，右键某一行代码可以选择一直运行到指定的那一行。
左边有个调试栏，可以看到变量的值，自动栏没有的可以手动添加：在代码里选中要监视的表达式，点右键有选项可以直接添加到 Watch 里，复杂的才需要手打。把鼠标放到变量上可以看到变量的值，但是只能识别简单的表达式。栈帧对于观察递归很有用。栈溢出和段错误时还可以抓取 “异常”，自动跳转到出错的行。

清理临时 exe 文件展开目录

清理临时文件按照这样配置，长期编译代码下来肯定有一大堆的 exe，还可能分散在不同的文件夹里。可以考虑修改一下 json 文件，把生成文件的目录指定到一个专门放 exe 的文件夹里；如果不会，百度 gcc 使用教程以及看我的 json 里的注释。或者资源管理器右上角搜索 *.exe 然后手动删除。也可也写个 bat，放到工作区里，要用的时候右键 Run Code：

  • del *.exe /q /s

  • del tempCodeRunnerFile.c /q /s

  • del a.out /q /s

  • del *.o /q /s

VSCode 常用快捷键展开目录

  • Ctrl+鼠标左键，是文件、函数等跳转。
  • Alt + ← ，是跳转后返回原处。
  • Ctrl + Shift + O，列出函数名。
  • Ctrl + P，列出近期打开的文件名。
  • Ctrl + Tab, 可以列出最近打开的文件，在开发时，两个文件间切换时效率很高。

上述是最常用的功能。其他功能请参考 VSCode 官网快捷键要注意下，在 windows 下，上述快捷是默认的。但在 linux、mac 下，Alt + ← 跳转返回原处 这一快捷键是无法使用的，原因是快捷键冲突。

作者：谭九鼎
链接：https://www.zhihu.com/question/30315894/answer/154979413
来源：知乎
文章内容有删改优化

版权属于：字节星球 / 肥柴之家 （转载请联系作者授权）
原文链接：https://www.bytecho.net/archives/vscode-cpp.html
本作品采用知识共享署名 - 非商业性使用 - 相同方式共享 4.0 国际许可协议进行许可。

计算机解决方案
Last Modified: September 21, 2024
Archives QR Code
QR Code for this page
Tipping QR Code
Leave a Comment

2 Comments
  1. zdhs zdhs IP属地：广西     Windows 7    Google Chrome
    Reply

    淘宝刷单单号 物流刷单单号 快递代发 www.**.cn

    1. Henry Henry     Windows    Google Chrome
      Reply

      @zdhs 公开处刑：刷广告者没？。