头文件声明接口、源文件实现细节;头文件含声明和模板定义,需防重复包含,源文件为独立编译单元生成目标文件,二者协作完成编译链接。

头文件(.h 或 .hpp)主要声明接口,源文件(.cpp)负责实现细节;编译器靠它们分工协作完成编译链接——头文件被“包含”进源文件,参与预处理和编译;源文件是独立的编译单元,生成目标文件后由链接器合并。
头文件干啥用:声明不定义
头文件里通常放类声明、函数声明、宏定义、模板定义、类型别名等,但避免放变量定义或函数实现(除非是内联函数或模板)。否则多个源文件包含同一头文件时,会导致重复定义错误(违反 ODR:One Definition Rule)。
- 例如:#include “utils.h” 只让编译器知道有个 int add(int, int);,不生成代码
- 头文件常配合 include guard(#pragma once 或 #ifndef XXX_H)防重复展开
- 模板和 constexpr 函数通常必须定义在头文件里——因为实例化需要看到完整定义
源文件干啥用:定义并生成目标码
源文件是编译的基本单位。每个 .cpp 文件经过预处理、编译、汇编后,生成一个 .o(或 .obj)目标文件,里面含实际的机器指令和符号(如函数地址、全局变量位置)。
- 函数体、全局 / 静态变量定义、类成员函数实现都写在这里
- 它可包含多个头文件,但自身不被其他文件直接“包含”,只参与链接
- 不同 .cpp 中可以有同名 static 函数,互不影响——static 限制 作用域 到本编译单元
编译过程中的真实分工
从预处理到链接,头和源的角色非常明确:
立即学习“C++ 免费学习笔记(深入)”;
- 预处理阶段:把 #include 后的头文件内容原样插入到 .cpp 中,形成一个“翻译单元”
- 编译阶段:每个翻译单元独立编译成目标文件;此时只检查语法 + 声明可见性,不关心函数是否真有定义
- 链接阶段:把所有目标文件中引用的符号(如未定义的 add)和对应定义(比如 utils.o 里的 add 实现)连起来;若找不到,报“undefined reference”
常见误用与后果
写错位置会直接导致编译失败或链接失败,而且错误信息往往不直观:
- 在头文件里写 int g_count = 0; → 每个包含它的 .cpp 都定义一次 → 链接时报“multiple definition”
- 在 .cpp 里声明函数但没写实现,又没在别处定义 → 编译通过,链接时报“undefined reference to xxx”
- 头文件里忘了加 include guard,且被间接多次包含(A.h 包含 B.h,main.cpp 同时包含 A.h 和 B.h)→ 重复声明,编译报错
基本上就这些。头文件是“契约”,源文件是“履约”。编译器靠这个分离来支持模块化和增量编译——改一个 .cpp,只需重编它;改头文件,才可能触发一批重编。
以上就是 C ++ 中的头文件和源文件有什么