头文件声明接口、源文件实现细节；头文件含声明和模板定义，需防重复包含，源文件为独立编译单元生成目标文件，二者协作完成编译链接。
头文件（.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，只需重编它；改头文件，才可能触发一批重编。
