使用VS Code Tasks编译含自定义头文件的C++程序时出现Undefined reference错误

问题根源 #

你的链接错误本质是Cars类的声明与实现不匹配，加上编译配置的细节问题：

• Cars.cpp里重新定义了完整的Cars类，而非基于头文件的声明去实现成员函数，导致头文件中的Cars和cpp文件中的Cars是两个完全独立的类，链接器找不到头文件声明的printcars()对应实现。
• tasks.json里的路径使用了单个反斜杠\，在JSON语法中需要转义为\\；另外无需将.h文件加入编译参数，头文件通过#include引入即可，不需要单独编译。

修复步骤 #

1. 修正Cars.cpp代码 #

将Cars.cpp改为基于头文件的实现方式，避免重复定义类：

#include "Cars.h"
#include <iostream>

// 实现头文件中声明的成员函数
void Cars::printcars(){
    std::cout << "Cars" << std::endl;
}

2. 修正tasks.json配置 #

调整编译参数，转义路径反斜杠并移除不必要的.h文件编译项：

{
    "version": "2.0.0",
    "tasks": [
        {
            "type": "cppbuild",
            "label": "buildFile",
            "command": "g++",
            "args": [
                "-o",
                "${fileBasenameNoExtension}.exe",
                "${file}",
                "${workspaceFolder}\\include\\*.cpp",
                "-I${workspaceFolder}\\include"
            ],
            "options": {
                "cwd": "${workspaceFolder}"
            },
            "problemMatcher": [
                "$gcc"
            ],
            "group": "build"
        }
        
    ]
}

• 把路径中的单个反斜杠\改为双反斜杠\\（JSON语法要求）
• 删除${workspaceFolder}\include\*.h项，头文件无需作为编译输入
• -I${workspaceFolder}\\include用于告诉编译器头文件的搜索路径，配置正确

3. 优化test.cpp的头文件引入（可选） #

由于已经通过-I指定了include目录，test.cpp中的头文件引入可以简化：

#include <iostream>
#include "Cars.h" // 无需写include/前缀，编译器会自动从指定路径查找

using namespace std;

int main(){
    Cars c;
    cout << "Hello!" << endl;
    c.printcars();  
}      

为什么直接包含Cars.cpp能运行？ #

当你直接包含Cars.cpp时，cpp文件中的类定义会被直接展开到test.cpp中，编译器能看到完整的类实现，无需在链接阶段查找外部定义，因此能正常编译，但这不符合C++工程规范，正确做法是头文件声明、cpp文件实现，分开编译后链接。

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