- LLVM Download Page 在此页面下载Clang。选 Pre-Built Binaries 中的 Windows (64-bit),不需要下.sig文件
- MinGW-w64 - for 32 and 64 bit Windows 在此页面下载 MinGW-w64,往下稍微翻一下,选最新版本中的
x86_64-posix-sjlj。最好不要用 Download Latest Version,这个是在线安装包,有可能因为国内的“网络环境”下载失败
安装Clang:添加环境变量时,选 Add LLVM to the system PATH for all users(即第二项,不过第三项也差不多);路径我填的是 C:\LLVM,也可以保持默认或者自己改。
安装MinGW-w64:下下来的是一个7z的压缩包,随便解压到哪,把东西全部复制(或者直接剪切)到Clang的文件夹里去(除非你有自己的想法),它们会无冲突合并,然后就可以把它删了:

验证
运行cmd,输clang或gcc,应该会提示 no input files 而不是“不是内部命令或外部命令”或者“无法将“clang”项识别为 cmdlet、函数、脚本文件或可运行程序的名称”,见下图。如果是“不是内部命令或外部命令”,说明clang.exe在的文件夹(我图里的是 C:\LLVM\bin)没有在环境变量中,要加到Path里才行。如果加了还是这样,重启。
输clang -v或gcc -v可以显示出各自的版本。如果显示出来的版本与你刚下的不同/更老,说明Path里原本有老版本的编译器,可能是安装其它IDE时装上的。则需要去掉原来的。
这两项验证一定要符合。如果你不知道怎么修改环境变量可以自己百度或者b站搜“环境变量”看视频(大多不是C的但是区别不大)。

安装扩展(extension)
必装:
- C/C++:又名 cpptools,提供Debug和Format功能
- C/C++ Clang Command Adapter:提供静态检测(Lint)功能
- Code Runner:右键即可编译运行单文件,很方便;但无法Dubug
其他可选扩展:
- Bracket Pair Colorizer:彩虹花括号
- Include Autocomplete:提供头文件名字的补全,不过用处不大;而且其实现在cpptools已经自带这个功能了,但本文不使用它的补全
- C/C++ Snippets:Snippets即重用代码块,效果自己百度;这个扩展安装量虽高,不过个人感觉用处实在不大,你也可以选择其他的Snippets扩展甚至自己定义
- One Dark Pro:大概是VS Code安装量最高的主题
- vscode-clangd:这个和Adapter二选一,出得比Adapter晚,下载量也低,但却是llvm官方出的。出现问题时可以换着试试
- Clang-Format:只有想自定义代码风格时才装,比如大括号不换行。需要另外学习如何使用
不建议/不需要装的扩展:
- GBKtoUTF8:把GBK编码的文档转换成UTF8编码的。此扩展可能有严重的bug。
- C++ Intellisense:用的是gtags,本文第一个版本的选择。效果非常非常一般。
FAQ
- Q: 为什么要装Clang?
A: 错误提示更友好。以及:Clang 比 GCC 好在哪里? - Q: 为什么既要装Clang又要装MinGW?
A: Clang没有stdio.h等头文件。至于为什么没有,我就不知道了 - Q: MSVC integration install failed / unable to find a Visual Studio installation…
A: Win下的Clang默认用的是MSVC的后端。如果完全按照本文接下来的操作,不用管这个提示
2. 配置四个.json文件
先创建一个你打算存放代码的文件夹(称作工作区),路径不能含有中文和空格和引号。C和C++需要分别建立不同的工作区,除非你懂得下面json文件的某些选项,则可以做到一个工作区使用不同的build task。
打开VSC,选打开文件夹,不要选“添加工作区文件夹”,理由见上一句。点新建文件夹,名称为 .vscode。这样操作的原因是Windows的Explorer不允许创建的文件夹第一个字符是点(但据说1809的下一个大版本支持了)。然后创建 launch.json,tasks.json,settings.json,c_cpp_properties.json放到.vscode文件夹下,效果图:


复制以下代码出来后,知乎会自动在前面加上几行保留所有权利的字,实际使用的时候肯定要删了的。
launch.json代码
stopAtEntry可根据自己喜好修改;cwd可以是程序运行时的相对路径,如有需要可以改为*${fileDirname}*(感谢
);现在的LLVM带有lldb-vscode这个程序,但我没试过能不能用。其他无需更改。type和request不变色是正常现象。
// https://github.com/Microsoft/vscode-cpptools/blob/master/launch.md
{
"version": "0.2.0",
"configurations": [
{
"name": "(gdb) Launch", // 配置名称,将会在启动配置的下拉菜单中显示
"type": "cppdbg", // 配置类型,这里只能为cppdbg
"request": "launch", // 请求配置类型,可以为launch(启动)或attach(附加)
"program": "${fileDirname}/${fileBasenameNoExtension}.exe", // 将要进行调试的程序的路径
"args": [], // 程序调试时传递给程序的命令行参数,一般设为空即可
"stopAtEntry": false, // 设为true时程序将暂停在程序入口处,我一般设置为true
"cwd": "${workspaceFolder}", // 调试程序时的工作目录
"environment": [], // 环境变量
"externalConsole": true, // 调试时是否显示控制台窗口,一般设置为true显示控制台
"internalConsoleOptions": "neverOpen", // 如果不设为neverOpen,调试时会跳到“调试控制台”选项卡,你应该不需要对gdb手动输命令吧?
"MIMode": "gdb", // 指定连接的调试器,可以为gdb或lldb。但我没试过lldb
"miDebuggerPath": "gdb.exe", // 调试器路径,Windows下后缀不能省略,Linux下则不要
"setupCommands": [ // 用处未知,模板如此
{
"description": "Enable pretty-printing for gdb",
"text": "-enable-pretty-printing",
"ignoreFailures": false
}
],
"preLaunchTask": "Compile" // 调试会话开始前执行的任务,一般为编译程序。与tasks.json的label相对应
}
]
}
tasks.json代码
如果是编写C++,编译器需改成clang++;如果想用MinGW就分别是gcc和g++,但注意把–target那条删去。
如果不想要额外警告,把-Wall那一条删去。
reveal可根据自己喜好修改,即使设为never,也只是编译时不跳转到“终端”而已,手动点进去还是可以看到,我个人设为never。
参数的作用我加了注释,还看不懂,百度gcc使用教程。
// https://code.visualstudio.com/docs/editor/tasks
{
"version": "2.0.0",
"tasks": [
{
"label": "Compile", // 任务名称,与launch.json的preLaunchTask相对应
"command": "clang", // 要使用的编译器,C++用clang++
"args": [
"${file}",
"-o", // 指定输出文件名,不加该参数则默认输出a.exe,Linux下默认a.out
"${fileDirname}/${fileBasenameNoExtension}.exe",
"-g", // 生成和调试有关的信息
"-Wall", // 开启额外警告
"-static-libgcc", // 静态链接libgcc
"--target=x86_64-w64-mingw", // clang的默认target为msvc,不加这一条就会找不到头文件;Linux下去掉这一条
"-std=c11" // C++最新标准为c++17,或根据自己的需要进行修改
], // 编译命令参数
"type": "shell", // 可以为shell或process,前者相当于先打开shell再输入命令,后者是直接运行命令
"group": {
"kind": "build",
"isDefault": true // 设为false可做到一个tasks.json配置多个编译指令,需要自己修改本文件,我这里不多提
},
"presentation": {
"echo": true,
"reveal": "always", // 在“终端”中显示编译信息的策略,可以为always,silent,never。具体参见VSC的文档
"focus": false, // 设为true后可以使执行task时焦点聚集在终端,但对编译c和c++来说,设为true没有意义
"panel": "shared" // 不同的文件的编译信息共享一个终端面板
}
// "problemMatcher":"$gcc" // 如果你不使用clang,去掉前面的注释符,并在上一条之后加个逗号。照着我的教程做的不需要改(也可以把这行删去)
}
]
}
settings.json代码
把这个文件里的东西放到“用户设置”里也可以覆盖全局设置,自己进行选择。
Code Runner的命令行和某些选项可以根据自己的需要在此处修改,用法还是参见此扩展的文档和百度gcc使用教程。
如果你要使用其他地方的头文件和库文件,需要要往clang.cflags和clang.cxxflags里加-I、-l和-L,用法百度gcc使用教程。
clang的补全,在我过去的测试过程中会让VSC非常卡,但是现在好像没有这个问题了。如果你卡,就把clang的补全关掉,用cpptools的(不需要我指明分别是哪两个吧?)。
Linux下去掉code runner和flags的–target,共四个。
感谢
提到的snippetSuggestions。
{
"files.defaultLanguage": "c", // ctrl+N新建文件后默认的语言
"editor.formatOnType": true, // 输入时就进行格式化,默认触发字符较少,分号可以触发
"editor.snippetSuggestions": "top", // snippets代码优先显示补全
"code-runner.runInTerminal": true, // 设置成false会在“输出”中输出,无法输入
"code-runner.executorMap": {
"c": "cd $dir && clang $fileName -o $fileNameWithoutExt.exe -Wall -g -Og -static-libgcc -fcolor-diagnostics --target=x86_64-w64-mingw -std=c11 && $dir$fileNameWithoutExt",
"cpp": "cd $dir && clang++ $fileName -o $fileNameWithoutExt.exe -Wall -g -Og -static-libgcc -fcolor-diagnostics --target=x86_64-w64-mingw -std=c++17 && $dir$fileNameWithoutExt"
}, // 设置code runner的命令行
"code-runner.saveFileBeforeRun": true, // run code前保存
"code-runner.preserveFocus": true, // 若为false,run code后光标会聚焦到终端上。如果需要频繁输入数据可设为false
"code-runner.clearPreviousOutput": false, // 每次run code前清空属于code runner的终端消息
"C_Cpp.clang_format_sortIncludes": true, // 格式化时调整include的顺序(按字母排序)
"C_Cpp.intelliSenseEngine": "Default", // 可以为Default或Tag Parser,后者较老,功能较简单。具体差别参考cpptools扩展文档
"C_Cpp.errorSquiggles": "Disabled", // 因为有clang的lint,所以关掉
"C_Cpp.autocomplete": "Disabled", // 因为有clang的补全,所以关掉
"clang.cflags": [ // 控制c语言静态检测的参数
"--target=x86_64-w64-mingw",
"-std=c11",
"-Wall"
],
"clang.cxxflags": [ // 控制c++静态检测时的参数
"--target=x86_64-w64-mingw",
"-std=c++17",
"-Wall"
],
"clang.completion.enable":true // 效果效果比cpptools要好
}
c_cpp_properties.json代码
如果你确定不需要使用别人的库,则现在的版本不需要创建这个文件了,扩展会自动使用默认的设置。
如果你自己编写了头文件又不在workspaceFolder下,或是使用别人的库,路径就要加到includePath和browse里(不过还有别的操作要做,见下一大点的多文件编译)。如果需要递归包含,末尾加/**
此文件内容来自于Microsoft/vscode-cpptools;这个json不允许有注释(其实按照标准本来就不能有)。
如果没有合并Clang和MinGW,则该文件中的compilerPath必需修改成MinGW的完整路径,精确到gcc.exe,否则会提示找不到头文件;Linux下是/usr/bin/gcc。
Windows下的目录分隔符为反斜杠,原本应使用两个反斜杠来转义,但直接用斜杠在VS Code中也接受。
When you set the
compilerPathproperty and change
intelliSenseModeto
clang-x64(or
gcc-x64in version 0.18.0 and higher), you no longer need to copy the system include path or defines to
includePath,
browse.path, or
definesto enable IntelliSense to work properly.
{
"configurations": [
{
"name": "MinGW",
"intelliSenseMode": "gcc-x64",
"compilerPath": "C:/LLVM/bin/gcc.exe",
"includePath": [
"${workspaceFolder}"
],
"defines": [],
"browse": {
"path": [
"${workspaceFolder}"
],
"limitSymbolsToIncludedHeaders": true,
"databaseFilename": ""
},
"cStandard": "c11",
"cppStandard": "c++17"
}
],
"version": 4
}
为什么要往json里写这么多的东西?因为VSC本身并没有对C语言特别优待,对其他许多语言也是这样。另外稍微提一下,以$开头的是VSC预定义的变量,具体参见:Variables Reference。
3. 写代码,编译,调试
新建文件后就可以写代码了,c语言源代码后缀是.c,c++是.cpp或.C或.cxx(这也要我教吗……)。代码文件在保存工作区内都可以,可以自己建立文件夹,不必放到.vscode文件夹里。但是还是前面的话,不要含有中文和空格和引号,也不要有像&这样的特殊符号;不然试试用rm删除一个叫做-rf的文件?
按Alt+Shift+F(或者右键菜单)可以格式化代码。出现Intellisense的时候按tab可以补全代码。
停止输入一小段时间(一秒)后就会有Lint,扩展会给一些建议性的warning(比如声明了变量但不使用),自己清楚就行。如果觉得不爽,也有方法不让它提示,比如去掉-Wall就会少一些。如果还想去掉更多的警告,自己找怎么做,我提示一下:-Wno-…。找好参数后加到clang.cflags、clang.cxxflags和tasks.json的args里。
按ctrl+shift+B单纯编译,按F5为运行并调试(运行前会自动编译);本来ctrl+F5为运行但不调试,但是在cpptools暂不支持,还是会调试。Follow: How to launch an application without debugging? · Issue #1201 · Microsoft/vscode-cpptools
在写程序初期,我强烈建议不要把f5当作编译来使用,因为有的bug只会产生警告,不会阻止编译,但这些东西越早期解决越好。编译信息会在底下的“终端”面板里,如果代码有错误,点进去可以看clang报的信息,但因为有Lint了,所以可以轻松很多。
加断点在列号前面点一下就行,如果想从一开始就停下来,可以加在main函数那里,或者launch.json中设置*“stopAtEntry”: true*。按f11可以一步一步进行,箭头所指的那行代码就是下一步要运行的代码。左边有个调试栏,可以看到变量的值,自动栏没有的可以手动添加表达式;把鼠标放到变量上可以看到变量的值,但是只能识别简单的表达式;栈帧对于观察递归很有用;在某些时候还可以抓取“异常”。
想在自带的终端里进行调试?见:Use the VSCode debugConsole instead of externalConsole · Issue #35 · Microsoft/vscode-cpptools。此功能应该已经实现了,不过我不打算用,所以就没管。
快捷键:vscode: Visual Studio Code 常用快捷键。英文文档中当然有快捷键的信息,还有Cheet Sheet可以看,而且英文文档会更新。这个单独列出来还是给初学者吧。
中文乱码见第六点。
Code Runner
如果你不需要调试,可以直接右键选run code,或者点右上角的播放按钮。如果在终端里运行,可以输入数据,但是少了显示时间的功能;在“输出”中则上面两项相反。
用它还可以在非工作区内编译运行程序,但executorMap记得放到全局设置里。在终端中按ctrl + c可以终止程序运行。
如果按照我的配置,task和code runner还有一点不同的是working directory。前者是你打开的文件夹,后者是文件所在的文件夹。当然它们也都可以自己修改。
其实Code Runner只是代替你手动输命令,功能并不强,算是适用场景不同吧。不要以为run code跑个Hello World很简单,Code Runner就很强,前面那么多配置都是垃圾了。
另外,楼下的答主韩骏就是此插件作者,有事统统找他(滑稽)。
多文件编译
如果你想进行少量的多文件编译,对于c语言请使用clang(gcc)把所有文件编译成.o的中间代码,再用clang++(g++)链接.o文件,(为了方便)并把这些命令写进批处理中;这个操作门槛非常低,如果不会,百度gcc使用教程。
如果你想进行大量的多文件编译,请学习如何写makefile或使用cmake。而配置Intellisense需要修改那几个JSON。
如果你想使用别人的库,比如ffmpeg,可能需要在命令中指定-I、-l(小写的L)、-L,以及阅读那个库的文档。总之这个VSC无关,不用VSC,或是用其它IDE,或是手动编译一样的会遇到这些问题。自行去解决。
这些情况下可以考虑单独建一个工作区,不要和单文件编译的共用。其实不用新建工程(Project),只是单文件就能调试,是不利于以后使用和理解大型IDE的,不要觉得建工程很麻烦、单文件很强就是了。
保存文件夹
如果你用VSC还做别的事(比如写前端),或者有不止一个工作区,可以创建一个快捷方式(右键新建),把工作区路径作为参数传给VSC主程序,还可以加个图标。这操作不难,记得打双引号就行。1.18有了一个窗口多个工作区的功能,“文件”菜单里也有“保存工作区”这个功能,但是我没试过。

某些可能出现的错误
- 如果你只写了个hello world,不加任何断点,按f5以后黑框框一闪而过是正常现象。想让程序暂停运行可以在末尾加上一个或两个getchar();,不明白为什么有时要用两个?去问你们C语言老师;或用system(“pause”),或加断点
- 如果你要进行调试,不要开优化。gcc用-Og还可以保留一些调试信息,但clang用了以后就不能用gdb调试了。即使如此我还是在某一次写代码的时候遇到了无法跳入函数的问题,而VS可以跳入
- 重命名文件后,原来已有的Lint还会在问题栏里;修改了文件后断点可能会失效。以及还存在一些其他的像这样的小bug,一般关掉VSC再开就行
- preLaunchTask“Compile”已终止,退出代码为 1:编译有error并且你用的是F5运行的就会有这个提示,有warning是否会触发不清楚;如果没有error,点仍然调试就行了;如果有error你还点仍然调试,就会调试上一次编译成功的文件。有一种原因是原程序仍在运行,无法被覆盖(比如死循环),终端里报错为permission denied,任务管理器结束那个进程即可。但其实所有的编译失败都会触发这个错误,出错的返回值是1难道不是常识?所以仅仅告诉我出现了这个提示根本没用,因为它的意思就是出错了,没有人能看出原因。这也是为什么我要强烈建议不要把F5当作编译来使用,按F5出了问题,我根本看不出是编译期有问题还是调试期有问题,或是你自己的代码有问题
- 无法打开…,找不到文件(file:///build/glibc-OTsEL5/glibc-2.27/…):我在Linux下遇到了这个问题,下一个glibc放到指定位置就行,
wget http://ftp.gnu.org/gnu/glibc/glibc-2.27.tar.xz,剩下的就不要问我了。或者参见这个:Disable “Unable to open file” during debug · Issue #811 · Microsoft/vscode-cpptools libmingw32.a(lib64_libmingw32_a-crt0_c.o):crt0_c.c:(.text.startup+0x2e): undefined reference to 'WinMain':这是你自己的代码有问题,没写main函数,或者把main写成了mian
4. 其他设置
我的一些其他的设置,用在全局settings.json里,根据自己的情况调整,不需要全部照着我的写。写完一个以后要打逗号。
现在的VSC用的是可视化的设置界面,其实原本是手动编辑且出现两列设置的。点击右上角那个花括号就能手动编辑。
"editor.fontFamily": "等距更纱黑体 SC", // 控制编辑器字体
"workbench.colorTheme": "One Dark Pro", // 主题
"files.trimTrailingWhitespace": true, // 保存时,删除每一行末尾的空格
"files.insertFinalNewline": true, // 保存后文件最末尾加一行空格
"workbench.colorCustomizations": {
"activityBar.foreground": "#39C5BB" // 自定义颜色
},
"git.enabled": false, // 如果你不用git,可以考虑关闭它
"git.ignoreMissingGitWarning": true, // 同上
"editor.minimap.enabled": false, // 我个人不用minimap,就是右边那个东西
"editor.dragAndDrop": false, // 选中文字后,可以拖动它们调整位置。我是不需要
"files.autoGuessEncoding": false, // 启用后,会在打开文件时尝试猜测字符集编码。我关闭的理由见6
"[c]": {
// "files.encoding": "gbk" // 这样的格式可以对指定后缀的文件应用设置,如果你实在想用gbk,就这样设置吧。cpp同理。
},
"window.zoomLevel": 0.2, // 整体放大
"workbench.settings.useSplitJSON": true, // 恢复手动编辑时的两列设置
更纱黑体是楼下B神做的字体,特点是标点好看(误):be5invis/Sarasa-Gothic
Consolas虽然是Windows自带字体中还算行的,但它只有英文字体;微软雅黑虽然是非衬线字体,但它不是等距的,这一点非常不适合编程,等线也不等距;中易宋体……告辞。不下新的字体,其他两大系统我不清楚,Windows下简直没有编程可用的字体。Consolas加雅黑嘛,也还行吧,不过能用更好的干嘛不用呢。
6. 关于乱码
VS Code输出会出现乱码,很多人都遇到过。这是因为VS Code内部用的是utf-8编码,cmd/Powershell是gbk编码。直接编译,会把“你好”输出成“浣犲ソ”。如果把cmd的活动代码页改成65001,会出现汉字只能显示一半的问题,而且怎么修改成UTF8还是个问题(这个可以参见楼下
同学的测试)。Linux就没有这个问题。
Consolas虽然是Windows自带字体中还算行的,但它只有英文字体;微软雅黑虽然是非衬线字体,但它不是等距的,这一点非常不适合编程,等线也不等距;中易宋体……告辞。不下新的字体,其他两大系统我不清楚,Windows下简直没有编程可用的字体。Consolas加雅黑嘛,也还行吧,不过能用更好的干嘛不用呢。
6. 关于乱码
VS Code输出会出现乱码,很多人都遇到过。这是因为VS Code内部用的是utf-8编码,cmd/Powershell是gbk编码。直接编译,会把“你好”输出成“浣犲ソ”。如果把cmd的活动代码页改成65001,会出现汉字只能显示一半的问题,而且怎么修改成UTF8还是个问题(这个可以参见楼下
同学的测试)。Linux就没有这个问题。
2万+

被折叠的 条评论
为什么被折叠?



