头文件声明接口，源文件实现逻辑。头文件含类、函数声明及常量，避免重复包含；源文件编写具体实现，包含头文件以使用其声明，二者分工明确，协同构建清晰代码结构。
在C++开发中，头文件（.h 或 .hpp）和源文件（.cpp）的分工明确，理解它们的区别和协作方式，有助于写出结构清晰、易于维护的代码。下面从文件作用、内容结构和编译流程三个层面来解析。
头文件的作用：声明接口
头文件主要用来声明函数、类、变量、宏等，不包含具体实现。它相当于一个“说明书”，告诉其他文件“这里有哪些功能可用”。
- 包含类的定义（成员函数声明、成员变量）
- 函数原型声明（如 int add(int a, int b);）
- 常量定义（使用 const 或 constexpr）
- 模板定义（通常需放在头文件中）
- 避免重复包含使用 #ifndef / #define / #endif 或 #pragma once
源文件的作用：实现逻辑
源文件是具体功能的“执行者”，负责实现头文件中声明的内容。
- 编写函数的具体逻辑
- 实现类的成员函数
- 定义全局变量（非声明）
- 可以包含多个头文件以使用其声明
例如，如果头文件中声明了一个函数 void print();，那么对应的源文件中会写：
立即学习“C++免费学习笔记（深入）”；
void print() {
std::cout << "Hello" << std::endl;
}
编译流程中的角色分工
C++程序从代码到可执行文件要经历预处理、编译、汇编、链接四个阶段。头文件和源文件在其中扮演不同角色。
- 预处理阶段：编译器处理 #include 指令，把头文件内容原样插入源文件中
- 编译阶段：每个 .cpp 文件独立编译成目标文件（.o 或 .obj），此时需要知道函数和类的声明
- 链接阶段：将多个目标文件合并，解决函数调用的地址引用问题
如果只在头文件中写实现，会导致多个源文件包含时产生重复定义错误。因此实现应放在源文件中。
常见误区与最佳实践
- 不要在头文件中定义非内联函数或全局变量（除非使用 inline 或 static）
- 模板和内联函数必须在头文件中定义，因为编译器需要在编译时看到完整代码
- 保持头文件最小化，只暴露必要的接口，减少编译依赖
- 使用前置声明（forward declaration）代替不必要的头文件包含
基本上就这些。头文件负责“说有什么”，源文件负责“做什么”，两者配合让C++项目模块化、可维护性强。理解这一点，对后续学习大型项目结构和库设计很有帮助。
