C / C++ / 系统课时
把类声明和实现拆开
把类声明和实现拆开
当一个类开始包含多个成员函数时,把所有代码都写在 main.cpp 会越来越难维护。本节把类的接口放进头文件,把成员函数定义放进源文件,再由使用者包含头文件,建立最基础、也最常见的 C++ 多文件工程组织方式。
学习目标
- 能把类声明放入
.h头文件,把成员函数实现放入.cpp源文件 - 理解声明、定义和
#include在多文件工程中的分工 - 能编译多个源文件并定位常见的链接错误
为什么要拆成头文件和源文件
类声明告诉其他代码“这个类型提供什么”,成员函数定义则说明“这些功能具体怎样实现”。把两者分开后,调用者通常只需要阅读头文件就能了解接口,而实现细节可以留在源文件中独立修改。
例如 Student 类可以由三个文件组成:Student.h 声明类型,Student.cpp 实现成员函数,main.cpp 使用这个类型。头文件会被多个源文件包含,因此通常还需要防止重复包含。
完成一次声明与实现分离
下面三个文件共同构成一个完整示例;单个文件属于片段示例,需要与另外两个文件放在同一目录后一起编译。
Student.h 只保存类声明:
#ifndef STUDENT_H
#define STUDENT_H
#include <string>
class Student {
public:
Student(const std::string& name, int age);
void printInfo() const;
private:
std::string name_;
int age_;
};
#endifStudent.cpp 包含头文件,并使用 Student:: 指明正在定义哪个类的成员函数:
#include "Student.h"
#include <iostream>
Student::Student(const std::string& name, int age)
: name_(name), age_(age) {
}
void Student::printInfo() const {
std::cout << name_ << " " << age_ << '\n';
}main.cpp 只需要包含头文件即可创建和使用对象:
#include "Student.h"
int main() {
Student student("张三", 18);
student.printInfo();
return 0;
}这里的关键是:头文件中的成员函数只有声明,而 Student.cpp 中提供真正定义。构造函数使用成员初始化列表初始化 name_ 和 age_,printInfo 后面的 const 也必须与头文件声明保持一致。
编译并验证多个源文件
以下命令以 GCC 或 Clang 的常见命令行环境为例。编译时必须同时提交 main.cpp 和 Student.cpp,否则编译器虽然能看到声明,链接器却找不到成员函数的实际实现。
g++ -std=c++17 main.cpp Student.cpp -o app
./app预期输出:
张三 18如果只执行 g++ -std=c++17 main.cpp -o app,常见结果不是“找不到头文件”,而是在链接阶段出现 undefined reference 一类错误,因为 Student.cpp 没有参与最终程序的构建。
拆分时最容易出错的地方
头文件和源文件中的函数签名必须一致。参数类型、const、命名空间以及类名限定只要不匹配,就可能变成两个不同的函数。成员函数在类外定义时还必须写出 Student::,否则它只是一个普通的自由函数。
头文件应包含自己声明所需的依赖。例如这里直接使用了 std::string,所以 Student.h 自己包含 <string>,不能依赖某个调用者碰巧提前包含它。通常也不要在头文件写 using namespace std;,因为头文件会把这种命名空间影响传播给所有包含它的源文件。
当类较小、只用于一次性练习时,把声明和实现写在同一个文件完全可以;当类型需要被多个源文件复用,或者实现开始增长时,拆成头文件和源文件会让接口边界、编译关系和维护责任都更清楚。