C++多文件编译调用头文件函数出现undefined reference错误如何解决

这个报错属于链接阶段错误，不是代码语法错误。链接器在全局符号表中找不到speak()函数的实现地址，所以抛出未定义引用错误，具体触发原因如下：

• Eclipse等IDE默认会自动扫描项目目录下所有.cpp源文件，统一参与编译和链接流程，所以相同代码可以正常运行
• VSCode默认的G++编译配置仅编译当前处于激活状态的单个.cpp文件，你只编译了Classes.cpp，包含speak()实现的Cat.cpp没有被加入编译链接队列，自然找不到对应实现

方案1：手动编译时指定所有源文件 #

直接在终端执行编译命令，把所有用到的.cpp文件都作为参数传入即可：

g++ Classes.cpp Cat.cpp -o main.exe

编译完成后运行生成的main.exe即可正常执行。

方案2：修改VSCode默认编译配置（一劳永逸） #

打开项目下.vscode目录中的tasks.json文件，找到编译参数中的${file}变量，替换为${fileDirname}\\*.cpp，修改后核心配置示例：

{
    "tasks": [
        {
            "type": "cppbuild",
            "label": "C/C++: g++.exe 生成活动文件",
            "command": "你的g++安装路径\\bin\\g++.exe",
            "args": [
                "-fdiagnostics-color=always",
                "-g",
                "${fileDirname}\\*.cpp", // 替换原来的${file}，编译当前目录所有cpp
                "-o",
                "${fileDirname}\\${fileBasenameNoExtension}.exe"
            ],
            "options": {
                "cwd": "你的g++安装路径\\bin"
            },
            "problemMatcher": [
                "$gcc"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            }
        }
    ],
    "version": "2.0.0"
}

修改后再执行编译就会自动把当前目录下所有.cpp文件都加入编译流程，后续拆分更多源文件也不需要反复修改配置。

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