VisualStudioCode配置CC++环境
前⾔
本⽂主要在作者:谭九⿍()的⽂章上进⾏抄袭,对⼀些步骤进⾏简化对初学者更友好。
如果你已经拥有⼀些命令⾏、程序编译和调试,以及使⽤VS Code的知识,请移步到原⽂获得更加详细的介绍。
VS Code 是微软发布⼀款跨平台的源代码编辑器,其拥有强⼤的功能和丰富的扩展,使之能适合编写许多语⾔。
本⽂⾯向初学者(但不是纯⼩⽩),分享⼀点我配置 C/C++ 的经验。
本⽂所有内容均可从VS Code的官⽅⽂档:以及各个扩展的⽂档中获得,并且他们还会进⾏更新。
我的环境:Windows 10 x64、macOS 10.15。VS Code的配置⽂件在Linux下应该也是通⽤的,但需要修改路径等部位配置。
环境的准备
VS Code 的官⽹和下载、安装最新的版本。VS Code只是⼀个编辑器,并不是IDE(集成开发环境)。不含编译器(和许多其它功能),所以编译器要⾃⼰安装好。如果想⽤其他⼯具链或单纯⽤官⽅扩展。
然后下载安装 MinGW-w64,其实 MinGW 和 MinGW-w64 只是名字像,它们是两个不同的项⽬。为了⽅便,本⽂中的 MinGW 指的其实都是 MinGW-w64。MinGW 本⾝已经很久没有更新了,故不推荐。下载以下两个程序(都要):
在此页⾯下载 Clang。选 Pre-Built Binaries 中的 Clang for Windows (64-bit),不需要下.sig⽂件
往下翻,在版本选择中选最新版本中的 x86_64-posix-h
由于⽂件在外⽹,部分同学下载太慢,故提供 Win64 版本⽅便下载:: 密码: g5h5
本⽂提供两种解决⽅案
gcc 精简版
下载安装 gcc 和 C/C++ 扩展,添加 gcc 环境变量,打开⽂件夹,新建 helloworld 源代码并保存,按 F1,输⼊build and debug active file。完。
增加环境变量
在我的电脑上右键点击属性,然后依次点击下⾯图⽚的操作,
之后点击确定即可
[注]:设置完系统环境变量之后需要重启 vs code
可选配置
在 vscode 中新建.vscode ⽂件夹,放⼊下⾯链接的四个 Json ⽂件。⾥⾯包含插件 code runner 运⾏配置和 C/C++ 的调试配置。
注意:修改c_cpp_properties.json中的 compilerPath,
"compilerPath": "${gcc的安装绝对路径}/mingw64/",
Clang + gcc 配置版
推荐使⽤, 详见:
环境的准备
下载 Clang 以后安装。添加环境变量时:选Add LLVM to the system PATH for all urs(即第⼆项,不过第三项也差不多)。Clang 的安装路径(Destination folder)我推荐填默认C:\Program Files\LLVM,不装那⾥也⾏,下⾯的配置⾥路径就⾃⼰改。安装完了以后可能会弹出 cmd 说MSVC integration install failed。这个是因为 Clang 默认使⽤的是 msvc 的⼯具链,⽽我们选择的⼯具链是 MinGW,所以就不⽤管这个提⽰。
MinGW解压在哪,解压好以后把 所在⽬录的所有东西全部复制到 Clang 的⽂件夹⾥去,
他们会⽆冲突合并【如下图】。同样,不做这⼀步也⾏,下⾯的配置⾥路径就⾃⼰改,添加 gcc 环境变量。
⾄于为什么既要装Clang⼜要装MinGW,是因为 Clang 没有头⽂件。然后就可以把MinGW删了。不建议安装多个MinGW,如果你安装了其他IDE需要注意把其他的 MinGW 从环境变量中去掉;也可以⾃⼰把他们的编译器设为 Clang。因为⼏乎所有的轻量级IDE⽤的都是 MinGW 或 TDM-GCC,它们不制造编译器,只是打包了⼀个。⽽且它们⽤在VSC⾥也会有奇怪的错误。
运⾏cmd,输clang,应该会提⽰no input files ⽽不是“不是内部命令或外部命令”或者“⽆法将“clang”项识别为 cmdlet、函数、脚本⽂件或可运⾏程序的名称”。输 clang -v 或 gcc -v 可以显⽰出各⾃的版本。如果是“不是内部命令或外部命令”,说明 在的⽂件夹(我的是C:\Program Files\LLVM\bin)没有在环境变量中,要加到path⾥才⾏。
win10 如果已经增加环境变量仍出现“不是内部命令或外部命令……” 请先尝试重启电脑。
将把 所在⽬录所有⽂件夹路径添加进去
需要安装的扩展:
C/C++(就是有些教程⾥的cpptools)
C/C++ Clang Command Adapter:提供静态检测(Lint),很重要
Code Runner:右键即可编译运⾏单⽂件,很⽅便
其他可选扩展:
Bracket Pair Colorizer:彩虹花括号
Include Autocomplete:提供头⽂件名字的补全
One Dark Pro:⼤概是VS Code安装量最⾼的主题
不建议/不需要装的扩展:
性交小小说
GBKtoUTF8:把GBK编码的⽂档转换成UTF8编码的。此扩展可能有严重的bug,参见第6点,总之不建议装
C++ Intellin:⽤的是gtags,本⽂第⼀个版本的选择。效果⾮常⾮常⼀般。
C/C++ Advanced Lint:即cppflylint,本⽂第⼆个版本的选择。会产⽣许多奇怪的警告。总之“过时”了
Clang-Format:Adapter包含了此功能
配置四个.json⽂件
先创建⼀个你打算存放代码的⽂件夹(称作⼯作区),路径不能含有中⽂和空格和引号。c 语⾔和 c++ 需要建⽴不同的⼯作区(除⾮你懂得下⾯json⽂件的某些选项,则可以做到⼀个⼯作区使⽤不同的 build task)。
打开VS Code,选打开⽂件夹(不要选“添加⼯作区⽂件夹”,理由见上⼀句),选择刚才那个⽂件夹,点VS Code上的新建⽂件夹,名称为.vscode(这样做的原因是Windows的Explorer 不允许创建的⽂件夹第⼀个字符是点),然后创建 launch.json,tasks.json,ttings.json,c_cpp_properties.json放到.vscode⽂件夹下,效果图:
特别注意:C/C++⽂件放在与.vscode 的所在的同级⽬录中,.vscode 只放置4个json⽂件。
launch.json代码:
stopAtEntry可根据⾃⼰喜好修改;cwd可以控制程序运⾏时的相对路径,如有需要可以改为${fileDirname}。其他⽆需更改,除⾮你不⽤windows,则可以⽤lldb调试(需要⾃⼰装)。type和request不变⾊是正常现象。
// /Microsoft/vscode-cpptools/blob/master/launch.md
{
"version": "0.2.0",
"configurations": [
{
"name": "(gdb) Launch", // 配置名称,将会在启动配置的下拉菜单中显⽰
"type": "cppdbg", // 配置类型,这⾥只能为cppdbg
"request": "launch", // 请求配置类型,可以为launch(启动)或attach(附加)
"program": "${fileDirname}/${fileBanameNoExtension}.exe", // 将要进⾏调试的程序的路径
"args": [], // 程序调试时传递给程序的命令⾏参数,⼀般设为空即可
"stopAtEntry": true, // 设为true时程序将暂停在程序⼊⼝处,我⼀般设置为true
"cwd": "${workspaceFolder}", // 调试程序时的⼯作⽬录
"environment": [], // (环境变量?)
"externalConsole": true, // 调试时是否显⽰控制台窗⼝,⼀般设置为true显⽰控制台
"internalConsoleOptions": "neverOpen", // 如果不设为neverOpen,调试时会跳到“调试控制台”选项卡,你应该不需要对gdb⼿动输命令吧?
"MIMode": "gdb", // 指定连接的调试器,可以为gdb或lldb。但⽬前lldb在windows下没有预编译好的版本。
"miDebuggerPath": "", // 调试器路径。
"tupCommands": [
{
"description": "Enable pretty-printing for gdb",
"text": "-enable-pretty-printing",
"ignoreFailures": fal
}
],
"preLaunchTask": "Compile" // 调试会话开始前执⾏的任务,⼀般为编译程序。与tasks.json的label相对应
}
]
}
tasks.json代码:
reveal控制编译时是否跳转到终端⾯板。可根据⾃⼰喜好修改;即使设为never,也只是不⾃动跳转,⼿动点进去还是可以看到信息。
命令⾏参数⽅⾯,-std 根据⾃⼰的需要修改。如果使⽤ Clang 编写C语⾔,把command 的值改成clang。
草原简笔画
如果使⽤ MinGW,编译 C ⽤ gcc,编译 c++⽤ g++,并把 -target 和 -fcolor 那两条删去。
如果不想要额外警告,把 -Wall 那⼀条删去。
Linux下不需要加-fexec-chart。
反正这些我都加了注释,还看不懂,百度gcc使⽤教程。
// /docs/editor/tasks
{去除眼袋
"version": "2.0.0",
"tasks": [
{
坐飞机去"label": "Compile", // 任务名称,与launch.json的preLaunchTask相对应
"command": "clang++", // 要使⽤的编译器
"args": [
"${file}",
"-o", // 指定输出⽂件名,不加该参数则默认输出a.exe
"${fileDirname}/${fileBanameNoExtension}.exe",
"-g", // ⽣成和调试有关的信息
"-Wall", // 开启额外警告
"-static-libgcc", // 静态链接
"-fcolor-diagnostics",
"--target=x86_64-w64-mingw", // 默认target为msvc,不加这⼀条就会找不到头⽂件
"-std=c++17" // C语⾔最新标准为c11,或根据⾃⼰的需要进⾏修改
], // 编译命令参数
"type": "shell",
"group": {
医院网络
"kind": "build",
"isDefault": true // 设为fal可做到⼀个tasks.json配置多个编译指令,需要⾃⼰修改本⽂件,我这⾥不多提
},
"prentation": {
"echo": true,
"reveal": "always", // 在“终端”中显⽰编译信息的策略,可以为always,silent,never。具体参见VSC的⽂档
"focus": fal, // 设为true后可以使执⾏task时焦点聚集在终端,但对编译c和c++来说,设为true没有意义
"panel": "shared" // 不同的⽂件的编译信息共享⼀个终端⾯板
}
// "problemMatcher":"$gcc" // 如果你不使⽤clang,去掉前⾯的注释符,并在上⼀条之后加个逗号。照着我的教程做的不需要改(也可以把这⾏删去) }
]
}
ttings.json代码:
把这个⽂件⾥的东西放到“⽤户设置”⾥也可以覆盖全局设置,⾃⼰进⾏选择。
Code Runner 的命令⾏和某些选项可以根据⾃⼰的需要在此处修改,⽤法还是参见此扩展的⽂档和百度gcc使⽤教程。
如果你要使⽤其他地⽅的头⽂件和库⽂件,可能要往 clang.cflags 和 flags ⾥加 -I 和 -L,⽤法百度 gcc 使⽤教程。
clang 的补全,在我过去的测试过程中会让VSC⾮常卡,但是现在好像没有这个问题了。落枕一般几天能好
如果你卡,就把 clang的补全关掉,⽤ cpptools 的。
Linux 下去掉 code runne r和 flags 的 --target 那⼀条,共四个。
{
"files.defaultLanguage": "cpp", // ctrl+N新建⽂件后默认的语⾔
"editor.formatOnType": true, //输⼊时就进⾏格式化,默认触发字符较少,分号可以触发
"editor.snippetSuggestions": "top", // snippets代码优先显⽰补全
"code-runner.runInTerminal": true, //设置成fal会在“输出”中输出,⽆法输⼊
"utorMap": {
"c": "cd $dir && clang $fileName -o $ -Wall -g -Og -static-libgcc -fcolor-diagnostics --target=x86_64-w64-mingw -std=c11 && $dir$fileNa "cpp": "cd $dir && clang++ $fileName -o $ -Wall -g -Og -static-libgcc -fcolor-diagnostics --target=x86_64-w64-mingw -std=c++17 && $dir }, //设置code runner的命令⾏
"code-runner.saveFileBeforeRun": true, // run code前保存
"code-runner.prerveFocus": true, //若为fal,run code后光标会聚焦到终端上。如果需要频繁输⼊数据可设为fal
"code-runner.clearPreviousOutput": fal, //每次run code前清空属于code runner的终端消息
"C_Cpp.clang_format_sortIncludes": true, //格式化时调整include的顺序(按字母排序)
"C_Cpp.intelliSenEngine": "Default", //可以为Default或Tag Parr,后者较⽼,功能较简单。具体差别参考cpptools扩展⽂档
山东分数线"Squiggles": "Disabled", //因为有clang的lint,所以关掉
"C_Cpp.autocomplete": "Disabled", //因为有clang的补全,所以关掉
"clang.cflags": [ //控制c语⾔静态检测的参数
"--target=x86_64-w64-mingw",
电脑截屏快捷键是哪个"-std=c11",
"-Wall"
],
"flags": [ // 控制c++静态检测时的参数
"--target=x86_64-w64-mingw",
"-std=c++17",
"-Wall"
],
"able":true //效果效果⽐cpptools要好
}
c_cpp_properties.json代码:
此⽂件内容来⾃于;这个json不允许有注释(其实按照标准本来就不能有)。
如果你没有合并 Clang 和 MinGW,则该⽂件中的 compilerPath 必需修改成 MinGW 的完整路径,精确到 ,否则会提⽰找不到头⽂件;Linux 下应该是 /usr/bin/gcc。
如果你⾃⼰编写了头⽂件⼜不在 workspaceFolder 下,路径也要加到 includePath 和 brow ⾥。这些路径是否递归有效暂时未知,我的测试是有效的。
Windows下的路径为反斜杠,原本应使⽤两个反斜杠来转义,但直接⽤斜杠在 VS Code 中也接受。
{
"configurations": [
{
"name": "MinGW",
"intelliSenMode": "clang-x64",
"compilerPath": "C:/Program Files/LLVM/",
"includePath": [
"${workspaceFolder}"
],
"defines": [],
"brow": {
"path": [
"${workspaceFolder}"
],
"limitSymbolsToIncludedHeaders": true,
"databaFilename": ""
},
"cStandard": "c11",
"cppStandard": "c++17"
}
],
"version": 4
}
以上是 clang+mingw 的json代码。
这是我的 clang+mingw 环境及测试,注意路径设置。
为什么要往 json ⾥写这么多的东西?因为 VSC 本⾝并没有对 C 语⾔特别优待,对其他许多语⾔也是这样。另外稍微提⼀下,以 $ 开头的是 VSC 预定义的变量,具体参见:。