本文内容参考文章Visual Studio Code 如何编写运行 C、C++ 程序?,此文章过于详细,摘其要成此文。
同时可以从VS Code官方文档获得参考与帮助:C++ programming with Visual Studio Code。
下载编译器
笔者由于安装过CodeBlocks,直接使用它的编译器,只需要将编译器bin文件夹(保证gcc.exe在此文件夹中)添加到系统环境变量中即可。
在cmd中使用gcc
命令进行测试。
使用gcc -v
命令查看编译器版本。
如果需要下载编译器,可以访问:MinGW-w64 - for 32 and 64 bit Windows,推荐下载 x86_64-posix-seh
。
补充知识:
- MinGW是gcc在Windows下的移植,gcc是世界上最流行的C/C++编译器组合。但gcc这个名字也指编译C语言的那个程序,g++才是C++编译器。即gcc程序和g++程序包含在gcc套件以及MinGW里,当只说gcc时要根据语境自己区分
- 其实MinGW和MinGW-w64只是名字像,它们是两个不同的项目
- MinGW还活着,但只能产生32位程序
- 现在MinGW-w64很久没有发布官方构建了,代码其实已经更新到了9.2.0,所以也可以考虑用基于它的TDM-GCC64。别下旧版,那是很久以前的,2020年发布了新版扩展是extension,插件是plugin,VSC用的是前者这种称呼
安装扩展
必要扩展:
- C/C++:又名 cpptools,提供Debug和Format功能
- Code Runner:右键即可编译运行单文件,很方便,但无法Debug
可选扩展:
- Bracket Pair Colorizer 2:彩虹花括号
- One Dark Pro:大概是VS Code安装量最高的主题
配置json文件
VSCode打开文件夹时,会检索文件夹中的.vscode
隐藏文件夹,并通过其中的.json
进行配置。
创建编写C或C++代码的文件夹,C和C++要分别创建单独的文件夹。
在C和C++文件夹中再创建名为.vscode
文件夹,在这个文件夹中放入三个文件:launch.json
,tasks.json
,settings.json
。
编辑这三个文件,按照需要自行修改。
launch.json
https://code.visualstudio.com/docs/cpp/launch-json-reference
{
"version": "0.2.0",
"configurations": [
{
"name": "(gdb) Launch",
"type": "cppdbg",
"request": "launch",
"program": "${fileDirname}/${fileBasenameNoExtension}.exe",
"args": [],
"stopAtEntry": false,
"cwd": "${workspaceFolder}",
"environment": [],
"externalConsole": true,
"internalConsoleOptions": "neverOpen",
"MIMode": "gdb",
"miDebuggerPath": "gdb.exe",
"setupCommands": [
{
"description": "Enable pretty-printing for gdb",
"text": "-enable-pretty-printing",
"ignoreFailures": false
}
],
"preLaunchTask": "Compile"
}
]
}
属性 | 描述 |
---|---|
name | 配置名称,将会在启动配置的下拉菜单中显示 |
type | 配置类型,对于C/C++可认为此处只能是cppdbg,由cpptools提供;不同编程语言不同 |
request | 可以为launch(启动)或attach(附加) |
program | 将要进行调试的程序的路径 |
args | 程序调试时传递给程序的命令行参数,一般设为空 |
stopAtEntry | 设为true时程序将暂停在程序入口处,相当于在main上打断点 |
cwd | 调试程序时的工作目录,此为工作区文件夹;改成${fileDirname}可变为文件所在目录 |
environment | 环境变量 |
externalConsole | 使用单独的cmd窗口,与其它IDE一致;为false时使用内置终端 |
internalConsoleOptions | 如果不设为neverOpen,调试时会跳到“调试控制台”选项卡,你应该不需要对gdb手动输命令吧? |
MIMode | 指定连接的调试器,可以为gdb或lldb。但我没试过lldb |
miDebuggerPath | 调试器路径,Windows下后缀不能省略,Linux下则不要 |
setupCommands | 模板自带,好像可以更好地显示STL容器的内容,具体作用自行Google |
preLaunchTask | 调试前执行的任务,一般为编译程序。与tasks.json的label相对应 |
tasks.json
https://code.visualstudio.com/docs/editor/tasks
{
"version": "2.0.0",
"tasks": [
{
"label": "Compile",
"command": "gcc",
"args": [
"${file}",
"-o",
"${fileDirname}/${fileBasenameNoExtension}.exe",
"-g",
"-m64",
"-Wall",
"-static-libgcc",
"-fexec-charset=GBK",
"-D__USE_MINGW_ANSI_STDIO",
],
"type": "process",
"group": {
"kind": "build",
"isDefault": true
},
"presentation": {
"echo": true,
"reveal": "always",
"focus": false,
"panel": "shared"
},
"problemMatcher": "$gcc"
}
]
}
属性 | 描述 |
---|---|
label | 任务名称,与launch.json的preLaunchTask相对应 |
command | 要使用的编译器,C++用g++ |
args | 编译的命令,其实相当于VSC帮你在终端中输了这些东西 |
type | process是把预定义变量和转义解析后直接全部传给command;shell相当于先打开shell再输入命令,所以args还会经过shell再解析一遍 |
reveal | 执行任务时是否跳转到终端面板,可以为always,silent,never。具体参见VSC的文档,即使设为never,手动点进去还是可以看到 |
focus | 设为true后可以使执行task时焦点聚集在终端,但对编译C/C++来说,设为true没有意义 |
panel | 不同的文件的编译信息共享一个终端面板 |
problemMatcher | 捕捉编译时终端里的报错信息到问题面板中,修改代码后需要重新编译才会再次触发 |
settings.json
{
"files.defaultLanguage": "c",
"editor.formatOnType": true,
"editor.suggest.snippetsPreventQuickSuggestions": false,
"editor.acceptSuggestionOnEnter": "off",
"code-runner.runInTerminal": true,
"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'"
},
"code-runner.saveFileBeforeRun": true,
"code-runner.preserveFocus": true,
"code-runner.clearPreviousOutput": false,
"code-runner.ignoreSelection": true,
"code-runner.fileDirectoryAsCwd": true,
"C_Cpp.clang_format_sortIncludes": true
}
属性 | 描述 |
---|---|
files.defaultLanguage | ctrl+N新建文件后默认的语言 |
editor.formatOnType | 输入分号(C/C++的语句结束标识)后自动格式化当前这一行的代码 |
editor.suggest.snippetsPreventQuickSuggestions | clangd的snippets有很多的跳转点,不用这个就必须手动触发Intellisense了 |
editor.acceptSuggestionOnEnter | 我个人的习惯,按回车时一定是真正的换行,只有tab才会接受Intellisense |
editor.snippetSuggestions | (可选)snippets显示在补全列表顶端,默认是inline,可改成top |
code-runner.runInTerminal | 设置成false会在“输出”中输出,无法输入 |
code-runner.executorMap | 右键run code时运行的命令;未注释的仅适用于PowerShell(Win10默认)和pwsh,文件名中有空格也可以编译运行;注释掉的适用于cmd(win7默认)、PS和bash,但文件名中有空格时无法运行 |
code-runner.saveFileBeforeRun | run code前保存 |
code-runner.preserveFocus | 若为false,run code后光标会聚焦到终端上。如果需要频繁输入数据可设为false |
code-runner.clearPreviousOutput | 每次run code前清空属于code runner的终端消息,默认false |
code-runner.ignoreSelection | 默认为false,效果是鼠标选中一块代码后可以单独执行,但C是编译型语言,不适合这样用 |
code-runner.fileDirectoryAsCwd | 将code runner终端的工作目录切换到文件目录再运行,对依赖cwd的程序产生影响;如果为false,executorMap要加cd $dir |
C_Cpp.clang_format_sortIncludes | 格式化时调整include的顺序(按字母排序) |
c_cpp_properties.json
如果你需要引用第三方库,则需要添加并编辑此文件,否则不需要。建议先跳过此步。
{
"configurations": [
{
"name": "GCC",
"includePath": ["${workspaceFolder}/**"],
"defines": ["_DEBUG", "UNICODE", "_UNICODE"],
"windowsSdkVersion": "10.0.18362.0",
"compilerPath": "C:/Program Files/mingw-w64/x86_64-8.1.0-posix-seh-rt_v6-rev0/mingw64/bin/g++.exe",
"cStandard": "c11",
"intelliSenseMode": "gcc-x64"
}
],
"version": 4
}
代码格式化
笔者设置的是在换行和保存时自动格式化文件。
偏好为大括号不换行,tab为四个空格。
在C_Cpp: Clang_format_fallback Style
设置项中设置{BasedOnStyle: Google, IndentWidth: 4}
。