M1 Mac编译带头文件的C++程序时出现Linker command failed错误

问题重现 #

使用M1芯片Mac，搭配VS Code和clang++（基于C17标准）编译多文件C程序时，遭遇链接错误：

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

相关代码文件如下：

main.cpp #

#include "test.h"

int main() 
{
    test obj = test();

    obj.Hello();

    return 0;
}

test.cpp #

#include "test.h"

void test::Hello()
{
    cout << "Hello World!" << endl;
}

test.h #

#include <iostream>

using namespace std;

class test
{
    public:
    explicit test();

    void Hello();
};

编译命令：

clang++ -std=c++17 main.cpp test.cpp -o testFile

问题原因 #

链接器报错的核心是：仅在头文件test.h中声明了test类的构造函数explicit test();，但未在test.cpp中提供该构造函数的具体实现。当main函数调用test()创建对象时，链接器找不到该函数的定义，因此抛出"Undefined symbols"错误。

解决方案 #

在test.cpp中补充构造函数的实现即可，即使构造函数为空（无需额外初始化逻辑）：

修改后的test.cpp代码：

#include "test.h"

// 补充构造函数实现
test::test() {}

void test::Hello()
{
    cout << "Hello World!" << endl;
}

验证编译 #

重新执行编译命令：

clang++ -std=c++17 main.cpp test.cpp -o testFile

编译通过后运行可执行文件：

./testFile

会输出：Hello World!

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