一、简介

        很多时候，开发者需要使用VSCODE进行C语言算法验证。而VSCODE的gcc编译，默认是只编译本文件的内容，其他.c文件是不参与编译的。这就给开发者带来很大的困扰，因为开发者不可能把所有的算法都写在一个.c文件，特别是还需要调用一些其他库的时候。

        所以，这里就来分享一下，使用VSCODE编译多个.c文件的方法。

二、实操

        先看如下代码：

void main(void) 
{printf("Hello from main.c\n");
}

        使用VSCODE运行后，可以正常输出。

        然后，创建如下文件结构。

        实现如下代码：

        可以看到，我们是希望在main函数中，调用hello.c里面的hello函数，从而打印数据。代码结构很简单，那编译一下看看结果。

        直接报错，提示 未定义hello函数（undefined reference to `hello'）。

        奇怪了，明明已经包含了hello的头文件，并且在头文件里面也已经声明了hello函数，为什么会未定义呢？

        这是因为vscode的gcc默认只编译本文件下的main函数。并不会链接其他文件。

        那如果我们希望链接其他文件，需要如何操作呢？

        

如果只关注结果，只配置settings.json文件即可。

        配置完settings.json文件后，可以正常编译执行。

tasks.json

         在vscode下按Ctrl+Shift+P或者F1来打开命令面板。

        输入 “Tasks:configure Task”，

         选择“c/c++:gcc.exe生成活动文件”

         此时在工程目录下会生成.vscode文件，并且里面会有tasks.json文件。

        这里简单介绍一下tasks.json文件。

        tasks.json文件是vscode的编译构建任务配置文件。在该文件中，可以定义多个任务，每个任务都包含了一些属性，例如任务名称、任务类型、执行命令等等。这些任务还可以指定执行依赖关系。通过配置tasks.json文件，可以方便地在vscode中执行这些任务，提高开发效率

属性介绍

type

        任务类型，有3个可选值，shell（执行shell）、process（运行进程）、cppbuild（C++程序编译构建）。其中前2个事VSCODE安装后即可提供的。cppbuild是安装C++扩展之后支持的。

label

        字符串类型，任务名，必选项。

command

        任务需要执行的具体命令，可以是外部程序或shell命令。如对于C++编译任务，就可能是gcc。

args

        命令执行的参数。

        ${workspaceFolder}：工作区文件夹的绝对路径，就是通过vscode’打开的项目文件夹的绝对路径名

        ${workspaceFolderBasename}：工作区文件夹的基本名称，是去掉上层文件路径只保留项目文件夹名

        ${file}：在vscode中当前打开正在显示或编辑的文件的绝对路径文件名

        ${relativeFile}：当前打开文件相对于工作区文件夹的相对路径名

        ${fileBasename}：当前打开文件的基本名称，不含路径名，但包含文件扩展名，在文件就存放在工作文件夹下时，与${relativeFile}内容一致，如果存放在打开文件夹下的子文件夹时，则二者不一致

        ${fileBasenameNoExtension}：当前打开文件的基本名称，不包括扩展名

        ${fileDirname}：当前打开文件所在的目录路径

        ${fileExtname}：当前打开文件的扩展名

        ${cwd}：启动 VS Code 的工作目录

        -o：gcc参数， 用于指定输出文件的名称。如果不使用此参数，编译器默认生成可执行文件a.out。

        -g：gcc参数，在可执行文件中加入源代码的信息，以便于调试。这并不意味着整个源文件被嵌入到可执行文件中，而是包含调试信息。

        -c：gcc参数，只生成目标文件（.o文件），而不连接成为可执行文件。这个参数通常用于编译不包含主程序的子程序文件。

        -I：gcc参数，指定头文件的文件夹。

        更多gcc参数，可以参考如下链接：20个最常用的GCC编译器参数 · 分布式服务器开发 · 看云

options

        可选项。cwd，设置编译过程的路径。

problematcher

        用于控制任务执行时问题匹配及输出。

group

        用于定义任务属于哪个组，有3个可选项，build、test、none。一般只会用到build

detail

        备注

settings.json

        该文件用于定义VSCODE的行为和外观。

        在vscode下按Ctrl+Shift+P或者F1来打开命令面板，并输入“open user tasks” 

         选择“打开用户任务”，会在当前文件夹的.vscode文件中，生成settings.json文件。但是文件为空。

        添加如下代码：

{"editor.fontSize": 17,"workbench.iconTheme": "vscode-icons","workbench.colorTheme": "Noctis Viola","editor.minimap.enabled": true,"C_Cpp.autocomplete": "Default","[cpp]": {"editor.quickSuggestions": true},"[c]": {"editor.quickSuggestions": true},"files.autoSave": "afterDelay","code-runner.executorMap": {"javascript": "node","java": "cd $dir && javac $fileName && java $fileNameWithoutExt","cpp": "cd $dir && g++ *.cpp -o $fileNameWithoutExt && $dir$fileNameWithoutExt","c": "cd $dir && gcc *.c -o $fileNameWithoutExt && $dir$fileNameWithoutExt","objective-c": "cd $dir && gcc -framework Cocoa $fileName -o $fileNameWithoutExt && $dir$fileNameWithoutExt","php": "php","python": "python -u","perl": "perl","perl6": "perl6","ruby": "ruby","go": "go run","lua": "lua","groovy": "groovy","powershell": "powershell -ExecutionPolicy ByPass -File","bat": "cmd /c","shellscript": "bash","fsharp": "fsi","csharp": "scriptcs","vbscript": "cscript //Nologo","typescript": "ts-node","coffeescript": "coffee","scala": "scala","swift": "swift","julia": "julia","crystal": "crystal","ocaml": "ocaml","r": "Rscript","applescript": "osascript","clojure": "lein exec","haxe": "haxe --cwd $dirWithoutTrailingSlash --run $fileNameWithoutExt","rust": "cd $dir && rustc $fileName && $dir$fileNameWithoutExt","racket": "racket","scheme": "csi -script","ahk": "autohotkey","autoit": "autoit3","dart": "dart","pascal": "cd $dir && fpc $fileName && $dir$fileNameWithoutExt","d": "cd $dir && dmd $fileName && $dir$fileNameWithoutExt","haskell": "runhaskell","nim": "nim compile --verbosity:0 --hints:off --run","lisp": "sbcl --script","kit": "kitc --run","v": "v run","sass": "sass --style expanded","scss": "scss --style expanded","less": "cd $dir && lessc $fileName $fileNameWithoutExt.css","FortranFreeForm": "cd $dir && gfortran $fileName -o $fileNameWithoutExt && $dir$fileNameWithoutExt","fortran-modern": "cd $dir && gfortran $fileName -o $fileNameWithoutExt && $dir$fileNameWithoutExt","fortran_fixed-form": "cd $dir && gfortran $fileName -o $fileNameWithoutExt && $dir$fileNameWithoutExt","fortran": "cd $dir && gfortran $fileName -o $fileNameWithoutExt && $dir$fileNameWithoutExt"},"terminal.integrated.defaultProfile.windows": "PowerShell"
}

        这里只需要关注 “code-runner.executorMap”中的“c”属性。

"c": "cd $dir && gcc *.c -o $fileNameWithoutExt && $dir$fileNameWithoutExt",

        该指令为gcc编译了当前目录下所有的.c文件。 

c_cpp_properties.json        

        该文件用于配置C/C++项目的编译器和intellisense设置。

        在vscode下按Ctrl+Shift+P或者F1来打开命令面板，并输入“edit configurations”

        选择“编辑配置”，会在当前文件夹的.vscode文件中，生成c_cpp_properties.json文件

属性介绍

name

        代表在什么系统上运行。

includePath

        编译文件的路径，默认是当前路径。可以根据需要进行修改，例如

${workspaceFolder}/**

defines

        定义符号，比如宏定义

cStandard

        略

cppStandard

        略

intelliSenseMode

        自动完成相关的配置