VS Code编译多文件C程序出现clang链接错误求助

我编写了三个简单的C文件：area.h、area.c、main.c，代码如下：

area.h #

//
//  area.h
//  modular
//
//  Created by Fryt Os on 14/01/2024.
//

#ifndef area_h
#define area_h

#include <stdio.h>

double areaRectangle(double width, double height);

#endif /* area_h */

area.c #

//
//  area.c
//  modular
//
//  Created by Fryt Os on 14/01/2024.
//

#include <stdio.h>
#include "area.h"

double areaRectangle(double width, double height){
    return width * height;
}

main.c #

//
//  main.c
//  modular
//
//  Created by Fryt Os on 14/01/2024.
//

#include <stdio.h>
#include "area.h"

int main(int argc, const char * argv[]) {
    double width = 4;
    double height = 2;
    double area = areaRectangle(width, height);
    printf("The area of the %fx%f (width x height) rectangle is %f\n", width, height, area);
    return 0;
}

在MacOS Sonoma 14.2.1系统的VS Code中运行时，执行命令：

frytos@MBP newModular % cd "/Users/frytos/code/newModular/" && gcc main.c -o main && "/Users/frytos/code/newModular/"main

出现以下编译错误：

ld: Undefined symbols:
  _areaRectangle, referenced from:
      _main in main-87d40c.o
clang: error: linker command failed with exit code 1 (use -v to see invocation)

环境信息：MacOS Sonoma 14.2.1，VS Code，已安装C/C++ Extension Pack、CMake、CMake Tools、Code Runner扩展；CLang版本为Apple clang version 15.0.0 (clang-1500.1.0.2.5)。

我尝试在Xcode中运行相同文件却能正常工作，希望有人能帮我理解VS Code下的问题所在并提供解决方法。

错误原因 #

你执行的编译命令只编译了main.c，未包含area.c。编译main.c时，编译器能通过area.h找到函数声明，但链接阶段找不到areaRectangle的具体实现（area.c未被编译为目标文件参与链接），因此抛出未定义符号的错误。Xcode会自动将项目内所有源文件纳入编译流程，所以可以正常运行。

解决方法 #

方法1：直接修改编译命令 #

将所有源文件加入编译命令，让gcc同时编译并链接：

cd "/Users/frytos/code/newModular/" && gcc main.c area.c -o main && "/Users/frytos/code/newModular/"main

方法2：配置VS Code的tasks.json（推荐） #

通过配置tasks.json让VS Code自动执行正确的编译流程：

1. 按Cmd+Shift+B，选择“创建tasks.json文件”，以“C/C++: clang build active file”为模板。
2. 修改tasks.json内容为：

{
    "version": "2.0.0",
    "tasks": [
        {
            "type": "cppbuild",
            "label": "C/C++: clang build all files",
            "command": "/usr/bin/clang",
            "args": [
                "-fcolor-diagnostics",
                "-fansi-escape-codes",
                "-g",
                "main.c",
                "area.c",
                "-o",
                "${fileDirname}/main"
            ],
            "options": {
                "cwd": "${fileDirname}"
            },
            "problemMatcher": [
                "$gcc"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "detail": "编译器: /usr/bin/clang"
        }
    ]
}

3. 保存后，按Cmd+Shift+B即可自动编译所有源文件并生成可执行文件。

方法3：使用CMake（适配复杂项目） #

利用已安装的CMake扩展管理编译：

1. 在项目根目录创建CMakeLists.txt文件：

cmake_minimum_required(VERSION 3.20)
project(modular)

add_executable(main main.c area.c)

2. 点击VS Code底部的“Configure”按钮，选择本地Clang编译器。
3. 点击“Build”按钮，CMake会自动生成编译配置并完成编译，之后即可运行生成的可执行文件。

内容的提问来源于stack exchange，提问作者Frytos