vscode修改c 项目_Visual Studio Code 如何编写运行 C、C++ 程序？

0. 前言

本文面向初学者(但不是纯小白)，分享一点我的经验。毕竟百度“VS Code C”出来的第一条就是这个网页现在不是了。其实VS Code真的不太适合写C，姑且算一种折腾吧。

本文所有内容均可从VS Code的官方文档：

C++ programming with Visual Studio Code

以及各个扩展的文档中获得，并且他们还会进行更新。(本文也进行过二点五次重大更新)如果你还想了解得更深一点，可以去看。其实本文基本上是由不断地尝试得出来的，如果有错误可以指出。

我的环境：64位Windows 10。如果你是32位的，在某些地方需要进行修改，不过本文中没有提，可以自己试着改。现在的配置在Linux下应该也是可用的。

1. 环境的准备

VS Code的官网和下载、安装，我就不多说了。点那个箭头可以下到其他操作系统的版本，现在x64系统下的直接是64位的，不用点箭头。另外VSC每个月都会更新一次(自动下载更新)，不要告诉我按照我的配置运行不了最后发现你用的是好几个月以前的版本。

VS Code只是一个编辑器，并不是IDE(集成开发环境)。不含编译器(和许多其它功能)，所以编译器要自己安装好。如果想用其他工具链或单纯用官方扩展，参见第九点。

其实MinGW和MinGW-w64只是名字像，它们是两个不同的项目。为了方便，本文中的MinGW指的其实都是MinGW-w64。MinGW本身已经很久没有更新了，故

不推荐

。下载以下两个程序(都要)：

LLVM Download Page

在此页面下载Clang。选Pre-Built Binaries中的Clang for Windows (64-bit)，

不需要下.sig文件

下载好了以后安装。添加环境变量时：选

Add LLVM to the system PATH for all users

(即第二项，不过第三项也差不多)。Clang的安装路径(Destination folder)我推荐填

C:\LLVM

，不装那里也行，下面的配置里路径就自己改。安装完了以后可能会弹出cmd说

MSVC integration install failed。

这个是因为Clang默认使用的是msvc的工具链，而我们选择的工具链是MinGW，所以就

不用管这个提示

。如果你想用别的工具链，参考第九点。

MinGW随便装哪，Architecture选x86_64，装好以后把东西全部复制到Clang的文件夹里去，他们会

无冲突合并

，效果图见下。同样，不做这一步也行，下面的配置里路径就自己改，还要手动把MinGW的bin文件夹加到path中，因为MinGW不会自己加。至于为什么既要装Clang又要装MinGW，是因为Clang没有头文件。然后就可以把MinGW删了(Uninstall.exe)。

不建议安装多个MinGW

，如果你安装了其他IDE需要注意把其他的MinGW从环境变量中去掉；也可以自己把他们的编译器设为Clang。因为几乎所有的轻量级IDE用的都是MinGW或TDM-GCC，它们不制造编译器，只是打包了一个。而且它们用在VSC里也会有奇怪的错误。

如果因为网络问题一直下载失败，建议优先自己

想办法

(懂我的意思吧？)。实在不行，我提供一个我下好的MinGW(7.2.0版)：

https://

pan.baidu.com/s/1slwTeb

V

运行cmd，输clang，应该会提示

no input files

而不是“不是内部命令或外部命令”或者“无法将“clang”项识别为 cmdlet、函数、脚本文件或可运行程序的名称”。输clang -v或gcc -v可以显示出各自的版本。如果是“不是内部命令或外部命令”，说明clang.exe在的文件夹(我的是

C:\LLVM\bin

)没有在环境变量中，要加到path里才行。怎么做自己百度。如果加了还是这样，重启。

需要安装的扩展：

C/C++(就是有些教程里的cpptools)

C/C++ Clang Command Adapter：提供静态检测(Lint)，很重要

Code Runner：右键即可编译运行单文件，很方便

其他可选扩展：

Bracket Pair Colorizer：彩虹花括号

Include Autocomplete：提供头文件名字的补全

C/C++ Snippets：Snippets即重用代码块，效果自己百度；这个扩展安装量虽高，不过个人感觉用处实在不大，你也可以选择其他的Snippets扩展甚至自己定义

One Dark Pro：大概是VS Code安装量最高的主题

vscode-clangd：这个和Adapter二选一，出得比Adapter晚，下载量也低，但却是llvm官方出的。出现问题时可以换着试试

不建议/不需要装的扩展：

GBKtoUTF8：把GBK编码的文档转换成UTF8编码的。此扩展可能有严重的bug，参见第6点，总之不建议装

C++ Intellisense：用的是gtags，本文第一个版本的选择。效果非常非常一般。

C/C++ Advanced Lint：即cppflylint，本文第二个版本的选择。会产生许多奇怪的警告。总之“过时”了

Clang-Format：Adapter包含了此功能

2. 配置四个.json文件

此节我当时大部分参考的是@blackkitty的文章，但是现在修改了很多。

先创建一个你打算存放代码的文件夹(称作工作区)，

路径不能含有中文和空格和引号

。c语言和c++需要建立不同的工作区(除非你懂得下面json文件的某些选项，则可以做到一个工作区使用不同的build task)。

打开VS Code，

选打开文件夹

(不要选“添加工作区文件夹”，理由见上一句)，选择刚才那个文件夹，点VS Code上的新建文件夹，名称为

.vscode

(这样做的原因是Windows的Explorer不允许创建的文件夹第一个字符是点)，然后创建 launch.json，tasks.json，settings.json，c_cpp_properties.json放到.vscode文件夹下，效果图：

复制以下代码时不要用ie打开本网页。(不过现在知乎已经完全不让ie访问了)复制出来以后，知乎会自动在前面加上几行保留所有权利的字，实际使用的时候肯定要删了的。

launch.json

代码：

stopAtEntry

可根据自己喜好修改；cwd可以控制程序运行时的相对路径，如有需要可以改为

${fileDirname}

(感谢

@xhx

)。其他无需更改，除非你不用windows，则可以用lldb调试(需要自己装)。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在windows下没有预编译好的版本。

"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

代码：

reveal

可根据自己喜好修改，即使设为never，也只是编译时不跳转到“终端”而已，手动点进去还是可以看到，我个人设为never。

命令行参数方面，

-std根据自己的需要修改

。如果使用Clang

编写C语言

，把

command

的值改成clang。如果使用MinGW，编译C用gcc，编译c++用g++，并把-target和-fcolor那两条删去。如果不想要额外警告，把-Wall那一条删去。参数的作用我加了注释，还看不懂，百度gcc使用教程。

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

"version": "2.0.0",

"tasks": [

"label": "Compile", // 任务名称，与launch.json的preLaunchTask相对应

"command": "clang++", // 要使用的编译器

"args": [

"${file}",

"-o", // 指定输出文件名，不加该参数则默认输出a.exe，Linux下默认a.out

"${fileDirname}/${fileBasenameNoExtension}.exe",

"-g", // 生成和调试有关的信息

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

"-static-libgcc", // 静态链接

"-fcolor-diagnostics", // 彩色的错误信息？但貌似clang默认开启而gcc不接受此参数

"--target=x86_64-w64-mingw", // clang的默认target为msvc，不加这一条就会找不到头文件；Linux下去掉这一条

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

], // 编译命令参数

"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，用法百度gcc使用教程。

clang的补全，在我过去的测试过程中会让VSC非常卡，但是现在好像没有这个问题了。如果你卡，就把clang的补全关掉，用cpptools的(不需要我指明分别是哪两个吧？)。

Linux下去掉code runner和flags的--target那一条，共四个。

感谢

@Wellin Boss

提到的snippetSuggestions。

{

"files.defaultLanguage": "cpp", // 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

代码：

此文件内容来自于

Microsoft/vscode-cpptools

；这个json不允许有注释(其实按照标准本来就不能有)。

如果你没有合并Clang和MinGW，则该文件中的compilerPath

必需

修改成MinGW的

完整

路径，精确到gcc.exe，否则会提示找不到头文件；Linux下应该是/usr/bin/gcc。

如果你自己编写了头文件又不在workspaceFolder下，路径也要加到includePath和browse里。这些路径是否递归有效暂时未知，我的测试是有效的。

Windows下的路径为反斜杠，原本应使用两个反斜杠来转义，但直接用斜杠在VS Code中也接受。

When you set the compilerPath property and change intelliSenseMode to clang-x64, you no longer need to copy the system include path or defines to includePath, browse.path, or defines to enable IntelliSense to work properly.

{

"configurations": [

"name": "MinGW",

"intelliSenseMode": "clang-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(这也要我教吗……)。代码文件在保存工作区内都可以(一级目录或者自己建立文件夹)，

不必

放到.vscode文件夹里，但是还是前面的话，不要含有中文和空格和引号。按Alt+Shift+F(或者右键)可以格式化代码。

停止输入一小段时间(一秒)后就会有Lint，扩展会给一些建议性的warning(比如声明了变量但不使用)，自己清楚就行。如果觉得不爽，也有方法不让它提示，比如去掉-Wall就会少一些。如果还想去掉更多的警告，自己找查怎么做，我提示一下：-Wno-...。找好参数后加到clang.cflags、clang.cxxflags和tasks.json的args里。

按ctrl+shift+B单纯编译，按F5为运行并调试(运行前会自动编译)；本来ctrl+F5为运行但不调试，但是在C中貌似没有用，还是会调试。在写程序初期，我强烈建议

不要把f5当作编译来使用

，因为有的bug只会产生警告，不会阻止编译，但这些东西越早期解决越好。编译信息会在底下的“终端”面板里，如果代码有错误，点进去可以看clang报的信息，但因为有Lint了，所以可以轻松很多。

加断点在列号前面点一下就行，如果想从一开始就停下来，可以加在main函数那里，或者

launch.json

中设置

"stopAtEntry": true

。按f11可以一步一步进行，箭头所指的那行代码就是

下一步要运行的代码

。左边有个调试栏，可以看到变量的值,自动栏没有的可以手动添加表达式；把鼠标放到变量上可以看到变量的值，但是只能识别简单的表达式；栈帧对于递归很有用；在某些时候还可以抓取“异常”。

如果你不需要调试，可以直接右键选run code。如果在终端里运行，可以输入数据，但是少了显示时间的功能；在“输出”中则上面两项相反。用它还可以在非工作区内编译运行程序，但executorMap记得放到全局设置里。在终端中按ctrl + C可以终止程序运行。但它其实只是帮你手动输命令，功能并不强，算是适用场景不同吧。另外，楼下的答主韩骏就是此插件作者，有事统统找他(滑稽)。

另外如果按照我的配置，task和code runner还有一点不同的是working directory。前者是你打开的文件夹，后者是文件所在的文件夹。当然它们也都可以自己修改。

如果你想进行少量的多文件编译，对于c语言请使用clang(gcc)把所有文件编译成.o的中间代码，再用clang++(g++)链接.o文件，(为了方便)并把这些命令写进批处理中；这个操作门槛非常低，如果不会，百度gcc使用教程。如果你想进行大量的多文件编译，请学习如何写makefile或使用cmake，并且修改tasks.json的command和args；这个稍微有一点难度。

如果你用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

4. 其他设置

我的一些其他的设置，用在全局settings.json里，根据自己的情况调整，不需要全部照着我的写。

写完一个以后要打逗号，最后一个就不用了

。

"editor.fontFamily": "等距更纱黑体 SC", // 控制编辑器字体

"workbench.colorTheme": "One Dark Pro", // 主题

"files.trimTrailingWhitespace": 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]": {