Ubuntu下VSCode编译多C++文件出现undefined reference错误如何解决

问题原因 #

你遇到的链接错误和程序不存在提示根源是VSCode默认的C++编译配置只编译当前活动的单个文件，不会自动关联项目里的其他源文件：

• 触发调试时仅编译了Main.cpp，没有编译Log.cpp和Math.cpp，链接器找不到Log和Multiply函数的实现，因此报错undefined reference
• 编译失败后没有生成可执行文件Main，因此启动调试时会提示program does not exist

解决步骤 #

方法1：修改tasks.json编译所有项目源文件 #

打开你的tasks.json，修改args配置项，把原来的${file}替换为当前目录下所有cpp文件的通配符：

"args": [
    "-fdiagnostics-color=always",
    "-g",
    "${fileDirname}/*.cpp", // 替换原来的${file}，编译当前目录所有cpp文件
    "-o",
    "${fileDirname}/${fileBasenameNoExtension}"
],

如果你的项目源文件存放在多个子目录，可以按需添加多个路径，比如：

"${fileDirname}/src/*.cpp",
"${fileDirname}/utils/*.cpp"

可选优化：补全头文件规范 #

建议你单独编写头文件声明函数，避免在每个调用文件里重复写函数声明：

1. 新建Log.h，内容：

#pragma once
void Log(const char* message);

2. 新建Math.h，内容：

#pragma once
int Multiply(int a, int b);

3. 在Main.cpp开头引入头文件，替换原来的函数声明：

#include <iostream>
#include "Log.h"
#include "Math.h"

进阶方案（适合大型项目） #

如果项目文件较多，建议使用Makefile或者CMake管理构建规则，VSCode可以直接识别CMake配置，不用每次修改tasks.json参数。

修改完成后打开Main.cpp按F5即可正常编译、调试整个项目。

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