VS Code中C++多文件编译出现未定义引用及可执行文件不存在错误

问题根源 #

VS Code默认的“Run C/C++ File”功能仅编译当前打开的单个.cpp文件。你的项目包含greet.cpp和hello.cpp两个源文件，单独编译greet.cpp时，链接阶段无法找到hello函数的实现，因此触发undefined reference to 'hello(std::istream&)'错误，最终导致可执行文件生成失败，出现program.exe does not exist提示。而命令行手动执行g++ -o greet.exe greet.cpp hello.cpp能正常运行，是因为你明确指定了所有需要参与编译链接的源文件。

解决方案 #

方案1：配置tasks.json实现自动多文件编译（推荐）

这是最通用的解决方案，能让VS Code自动编译当前目录下所有.cpp文件：

1. 按下Ctrl+Shift+P打开命令面板，输入Tasks: Configure Task，选择C/C++: g++.exe build active file（若没有该选项，选Create tasks.json file from template -> Others）。
2. 将生成的tasks.json内容替换为以下配置：

{
    "version": "2.0.0",
    "tasks": [
        {
            "type": "cppbuild",
            "label": "C/C++: g++.exe 生成活动文件",
            "command": "g++.exe",
            "args": [
                "-fdiagnostics-color=always",
                "-g",
                "${fileDirname}/*.cpp",
                "-o",
                "${fileDirname}/${fileBasenameNoExtension}.exe"
            ],
            "options": {
                "cwd": "${fileDirname}"
            },
            "problemMatcher": [
                "$gcc"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "detail": "编译器: g++.exe"
        }
    ]
}

3. 配置完成后，按Ctrl+Shift+B执行编译任务，编译成功后点击右上角“Run C/C++ File”或按F5即可正常运行。

方案2：临时指定依赖文件（快速测试用）

若不想配置tasks.json，可通过修改C/C++配置临时添加依赖文件：

1. 按下Ctrl+Shift+P打开命令面板，输入C/C++: Edit Configurations (UI)。
2. 在Compiler Args选项中，添加${fileDirname}/hello.cpp（多个依赖文件依次添加）。
3. 再次点击“Run C/C++ File”时，编译器会将指定的依赖文件一起编译。

注意事项 #

• 确保所有源文件在同一目录下，若文件分布在子目录，需修改tasks.json中${fileDirname}/*.cpp为对应路径（如${fileDirname}/src/*.cpp）。
• 你的头文件保护宏（GUARD_hello_h）使用正确，无需修改。

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