C / C++ / 系统课时

把类声明和实现拆开

把类声明和实现拆开

当一个类开始包含多个成员函数时,把所有代码都写在 main.cpp 会越来越难维护。本节把类的接口放进头文件,把成员函数定义放进源文件,再由使用者包含头文件,建立最基础、也最常见的 C++ 多文件工程组织方式。

学习目标

  • 能把类声明放入 .h 头文件,把成员函数实现放入 .cpp 源文件
  • 理解声明、定义和 #include 在多文件工程中的分工
  • 能编译多个源文件并定位常见的链接错误

为什么要拆成头文件和源文件

类声明告诉其他代码“这个类型提供什么”,成员函数定义则说明“这些功能具体怎样实现”。把两者分开后,调用者通常只需要阅读头文件就能了解接口,而实现细节可以留在源文件中独立修改。

例如 Student 类可以由三个文件组成:Student.h 声明类型,Student.cpp 实现成员函数,main.cpp 使用这个类型。头文件会被多个源文件包含,因此通常还需要防止重复包含。

完成一次声明与实现分离

下面三个文件共同构成一个完整示例;单个文件属于片段示例,需要与另外两个文件放在同一目录后一起编译。

Student.h 只保存类声明:

cpp
#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_;
};

#endif

Student.cpp 包含头文件,并使用 Student:: 指明正在定义哪个类的成员函数:

cpp
#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 只需要包含头文件即可创建和使用对象:

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,否则编译器虽然能看到声明,链接器却找不到成员函数的实际实现。

bash
g++ -std=c++17 main.cpp Student.cpp -o app
./app

预期输出:

text
张三 18

如果只执行 g++ -std=c++17 main.cpp -o app,常见结果不是“找不到头文件”,而是在链接阶段出现 undefined reference 一类错误,因为 Student.cpp 没有参与最终程序的构建。

拆分时最容易出错的地方

头文件和源文件中的函数签名必须一致。参数类型、const、命名空间以及类名限定只要不匹配,就可能变成两个不同的函数。成员函数在类外定义时还必须写出 Student::,否则它只是一个普通的自由函数。

头文件应包含自己声明所需的依赖。例如这里直接使用了 std::string,所以 Student.h 自己包含 <string>,不能依赖某个调用者碰巧提前包含它。通常也不要在头文件写 using namespace std;,因为头文件会把这种命名空间影响传播给所有包含它的源文件。

当类较小、只用于一次性练习时,把声明和实现写在同一个文件完全可以;当类型需要被多个源文件复用,或者实现开始增长时,拆成头文件和源文件会让接口边界、编译关系和维护责任都更清楚。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

把类声明和实现拆开

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通