C++中头文件（.h）和源文件（.cpp）的区别_C++代码结构与文件划分详解

头文件（.h）用于声明接口，源文件（.cpp）实现具体逻辑，二者分离可提升编译效率、代码复用性并隐藏实现细节，符合C++项目组织规范。

在C++开发中，合理划分代码结构是编写可维护、可复用程序的基础。头文件（.h）和源文件（.cpp）的分工协作，是C++项目组织的核心方式之一。理解它们的区别与作用，有助于写出更清晰、高效的代码。

头文件（.h）的作用：声明接口

头文件主要用于声明，不包含具体实现。它告诉编译器有哪些类、函数、变量或常量可供使用。

典型内容包括：

• 类的定义（成员变量、成员函数的声明）
• 函数原型（返回类型、参数列表）
• 全局变量的声明（使用extern）
• 常量定义（如const或constexpr）
• 类型别名（typedef或using）
• 模板定义（通常需全部写在头文件中）

头文件可以被多个源文件包含，因此要防止重复包含，通常使用#pragma once或传统的#ifndef/#define/#endif宏保护。

源文件（.cpp）的作用：实现逻辑

源文件负责具体的代码实现。它将头文件中声明的内容用实际的语句完成。

主要特点包括：

• 包含对应的头文件（如MyClass.cpp包含MyClass.h）
• 实现类成员函数和独立函数的具体逻辑
• 定义静态成员变量或全局变量
• 编写main函数（程序入口）

源文件在编译时会被单独编译成目标文件（.o或.obj），再由链接器合并成可执行文件。

为何要分离声明与实现？

这种结构设计不是强制的，但有明显优势：

• 提高编译效率：修改实现时只需重新编译对应.cpp文件，不影响其他模块
• 增强代码复用性：头文件可被多个项目包含，便于共享接口
• 隐藏实现细节：使用者只需关注.h中的接口，不必了解内部逻辑
• 避免重复定义：函数和变量的定义只出现在一个.cpp中，符合ODR（One Definition Rule）

一个简单示例

MathUtils.h

#pragma once
int add(int a, int b);

MathUtils.cpp

#include "MathUtils.h"
int add(int a, int b) {
    return a + b;
}

main.cpp

#include 
#include "MathUtils.h"
int main() {
    std::cout << add(3, 4) << std::endl;
    return 0;
}

这个例子展示了典型的三文件结构：头文件声明函数，源文件实现函数，主程序调用接口。

基本上就这些。掌握.h和.cpp的分工，是写出规范C++代码的第一步。虽然小项目可以全写在一个文件里，但一旦代码变多，良好的文件划分会让开发轻松很多。