20201026-Visual Studio Code 如何编写运行 C【参考转载】

Visual Studio Code 如何编写运行 C

1 首先需要一个编译环境

可以选clang

或者选gcc

而在windows下，gcc环境一般就是安装cygwin或是mingw

2 环境验证

cmd

clang -v

gcc -v

可以查看到版本信息

一般情况下，需要设置环境变量

3 安装好vscode后，安装扩展包

必装：

• 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：只有想自定义代码风格时才装，比如大括号不换行。需要另外学习如何使用

4 配置文件

配置四个.json文件

先创建一个你打算存放代码的文件夹（称作工作区），路径不能含有中文和空格和引号。C和C++需要分别建立不同的工作区，除非你懂得下面json文件的某些选项，则可以做到一个工作区使用不同的build task。

打开VSC，选打开文件夹，不要选“添加工作区文件夹”，理由见上一句。点新建文件夹，名称为 .vscode。这样操作的原因是Windows的Explorer不允许创建的文件夹第一个字符是点（但据说1809的下一个大版本支持了）。然后创建 launch.json，tasks.json，settings.json，c_cpp_properties.json放到.vscode文件夹下，效果图：

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-iOMYJ8l6-1607310479400)(20201026-Visual Studio Code 如何编写运行 C.assets/v2-f258256ae42b04e30a996f86a3676aa3_hd.jpg)]

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-7KeDzv4K-1607310479414)(20201026-Visual Studio Code 如何编写运行 C.assets/v2-526f46888adffe5b165f26244d193ce8_hd.jpg)]

复制以下代码出来后，知乎会自动在前面加上几行保留所有权利的字，实际使用的时候肯定要删了的。

launch.json代码

stopAtEntry可根据自己喜好修改；cwd可以是程序运行时的相对路径，如有需要可以改为*${fileDirname}*（感谢

@xhx

）；现在的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，共四个。

感谢

@Wellin Boss

提到的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语言特别优待，对其他许多语言也是这样。

5 Code Runner

如果你不需要调试，可以直接右键选run code，或者点右上角的播放按钮。如果在终端里运行，可以输入数据，但是少了显示时间的功能；在“输出”中则上面两项相反。

用它还可以在非工作区内编译运行程序，但executorMap记得放到全局设置里。在终端中按ctrl + c可以终止程序运行。

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

其实Code Runner只是代替你手动输命令，功能并不强，算是适用场景不同吧。不要以为run code跑个Hello World很简单，Code Runner就很强，前面那么多配置都是垃圾了。