头文件负责声明，源文件负责实现。头文件（.h）包含类、函数、变量等的声明，通过#include引入，配合头文件守卫防止重复包含；源文件（.cpp）实现具体逻辑，每个.cpp独立编译为目标文件。编译时预处理器插入头文件内容，编译器生成目标文件，链接器合并并解析符号引用。合理组织代码应遵循：一对一命名、减少头文件依赖、模板和内联函数置于头文件、避免在头文件定义非内联函数或全局变量，以提升编译效率与模块化程度。
在C++开发中，代码的组织方式直接影响项目的可维护性和编译效率。理解头文件（.h 或 .hpp）和源文件（.cpp）的作用，是掌握C++项目结构的基础。
头文件：声明的集中地
头文件主要用于存放函数、类、变量、模板等的声明，而不是实现。它的作用是告诉编译器“这些东西存在”，供其他源文件引用。
常见内容包括：
- 类的定义（成员变量、成员函数声明）
- 函数原型（返回类型、函数名、参数列表）
- 全局常量或宏定义（如用#define或const）
- 模板定义（通常需放在头文件中，因编译时需可见）
- 内联函数（inline function）的实现
通过#include "xxx.h"，其他源文件可以获取这些声明，确保跨文件调用时类型匹配。
立即学习“C++免费学习笔记（深入）”；
为防止重复包含，头文件通常使用头文件守卫或#pragma once：
#ifndef MYCLASS_H
#define MYCLASS_H
class MyClass {
public:
void doSomething();
};
#endif // MYCLASS_H
源文件：实现的具体位置
源文件（.cpp）用于存放函数和类成员函数的具体实现。它将头文件中的声明转化为可执行代码。
例如：
// MyClass.cpp #include "MyClass.h" #includevoid MyClass::doSomething() { std::cout << "Doing something..." << std::endl; }
源文件是编译的基本单位。每个.cpp文件会被独立编译成目标文件（.o 或 .obj），之后由链接器合并成最终的可执行程序。
把实现放在源文件中，能减少头文件的依赖传播，加快编译速度，也利于代码隐藏和模块化设计。
编译与链接过程解析
C++程序的构建分为两个主要阶段：编译和链接。
在编译阶段：
- 预处理器处理#include，将头文件内容插入到源文件中
- 编译器检查语法，并为每个.cpp生成对应的目标文件
在链接阶段：
- 链接器将多个目标文件合并
- 解析函数和变量的外部引用，确保所有符号都能找到定义
如果只有声明没有定义，会报“undefined reference”；如果多个源文件定义了同一符号（如非内联函数重复定义），则会引发“multiple definition”错误。
合理组织代码的建议
良好的代码组织能提升项目清晰度和协作效率。
- 一个类通常对应一个头文件和一个源文件，命名一致（如Student.h和Student.cpp）
- 尽量减少头文件中的#include，可用前置声明（forward declaration）降低耦合
- 模板和内联函数写在头文件中，因它们需要在使用点可见
- 避免在头文件中定义非内联函数或全局变量，防止多重定义
基本上就这些。头文件负责“说有什么”，源文件负责“做什么”，两者配合实现模块化编程，是C++工程化的基石。
