C++头文件与实现文件链接错误：undefined reference问题求助

你遇到的链接错误核心原因很明确：单独编译main.cpp时，编译器只处理了这个源文件的代码，没有将calculation.cpp的函数实现纳入链接流程。直接包含.cpp文件能运行是因为把所有代码合并成了一个编译单元，而你用g++ -o main.exe main.cpp calculation.cpp成功编译，本质是让编译器同时处理了两个源文件并完成了链接。

下面是标准的头文件使用流程，确保代码结构规范且编译正常：

1. 规范头文件结构 #

在calculation.h中仅保留函数声明，并添加头文件保护（避免重复包含问题）：

#ifndef CALCULATION_H
#define CALCULATION_H

// 函数声明
int add(int a, int b);
int sub(int a, int b);

#endif

2. 正确实现源文件 #

calculation.cpp包含头文件并实现函数：

#include "calculation.h"

// 函数实现
int add(int a, int b) {
    return a + b;
}

int sub(int a, int b) {
    return a - b;
}

3. 主文件仅包含头文件 #

main.cpp只需包含calculation.h，无需包含.cpp文件：

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

int main() {
    std::cout << "5+3=" << add(5, 3) << std::endl;
    std::cout << "5-3=" << sub(5, 3) << std::endl;
    return 0;
}

4. 正确的编译方式 #

方式一：分步编译+链接 #

先编译calculation.cpp生成独立的目标文件，再和main.cpp的编译结果链接：

# 编译calculation.cpp为目标文件calculation.o
g++ -c calculation.cpp -o calculation.o
# 编译main.cpp并链接calculation.o生成可执行文件
g++ main.cpp calculation.o -o main.exe

方式二：一次性编译所有源文件 #

这就是你之前成功的命令，本质是编译器自动完成了编译和链接的全过程：

g++ -o main.exe main.cpp calculation.cpp

为什么单独编译main.cpp会报错？ #

当你只执行g++ main.cpp -o main.exe时，编译器仅处理main.cpp的代码：看到add和sub的声明，但找不到对应的实现代码（这些实现只在calculation.cpp里），链接阶段就会抛出undefined reference错误。必须把calculation.cpp的编译产物（目标文件）和main.cpp的编译产物链接在一起，才能让程序找到函数的具体实现。

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