C++头文件与源文件的包含规则及单命令编译方法

首先明确三个基础原则：

• 头文件（.h）只放类、函数、变量的声明，源文件（.cpp）放具体实现
• 永远不要#include任何.cpp后缀的源文件，源文件是编译器单独处理的编译单元，直接包含会触发重复定义错误
• 所有头文件开头必须加头文件保护，推荐直接写#pragma once，兼容性足够且写法简单，防止头文件被重复包含引发编译错误

各文件的具体包含逻辑如下：

• A.h
  • 仅放A类的声明
  • 如果A类声明中存在B类的实例成员、或者A类继承自B类，才需要在这里#include "B.h"；如果只是用到B类的指针、引用，直接写前向声明class B;即可，不需要包含B.h，减少不必要的编译依赖
• A.cpp
  • 第一行优先包含自己对应的头文件#include "A.h"（这个写法可以第一时间检测出头文件的依赖遗漏问题，是通用最佳实践）
  • 如果A类的实现逻辑中调用了B类的方法、访问了B类的成员，在这里#include "B.h"即可，不需要把依赖挪到A.h里
• B.h
  • 规则和A.h完全一致：仅放B类声明，按需包含依赖头文件或者写前向声明，开头加头文件保护
• B.cpp
  • 第一行优先包含#include "B.h"，实现中用到A类的话直接在本文件包含#include "A.h"
• Main.cpp
  • 主函数里用到了哪个类，就直接包含对应类的头文件即可，用到A和B就写#include "A.h"、#include "B.h"

补充说明：头文件的包含没有强制的固定写法，核心目标是在满足编译依赖的前提下，尽可能减少头文件之间的互相包含，降低代码耦合、提升编译速度。

完全可以，不需要额外的构建工具，直接调用编译器把所有参与编译的源文件列在同一条命令中即可，不需要把头文件写在命令参数里，头文件会被源文件中的#include语句自动引入。
以最常用的GCC编译器为例，在项目根目录执行以下命令即可一次性完成所有文件的编译、链接，生成可执行文件：
g++ A.cpp B.cpp Main.cpp -o main
命令解释：

• 前面依次列出所有需要编译的.cpp源文件
• -o main参数指定最终输出的可执行文件名为main，Windows环境下会自动生成main.exe，Linux/macOS环境下生成无后缀的main可执行文件，直接运行即可。
  如果你用的是Clang编译器，只需要把命令开头的g++替换成clang++，其余参数完全一致。
  如果后续项目源文件数量增多，单条命令书写维护麻烦，再考虑使用Makefile、CMake这类构建工具即可，当前3个源文件的规模用单条命令完全足够。

内容的提问来源于stack exchange，提问作者Ralph Bear