C++项目中何时使用#include "example.h"及头文件依赖问题

一、什么时候需要用#include？ #

• 当代码需要直接使用某个实体的完整定义时：比如要创建类的对象、调用成员函数、访问成员变量，或是使用某个宏、typedef定义的类型，必须包含对应头文件。
• 仅需声明某个类/函数存在（比如用class Engine;做前向声明）时，不需要包含头文件——这也是解决你遇到的循环包含问题的核心方法。

二、使用某个类是否必须包含其头文件？ #

不一定，分两种场景：

• 若只是声明该类的指针/引用，或是将其作为函数的参数、返回类型（仅需知道这个类存在），用前向声明class Engine;即可，无需包含头文件。
• 若要实际操作类的具体内容：比如创建对象Engine e;、调用成员e.start();、访问成员变量，或是继承该类，就必须包含它的头文件。

三、间接包含头文件后，能否直接访问目标类？ #

不行，除非目标类的完整定义被显式包含在你引入的头文件里。
拿你举的Car和Engine的例子：

• 如果Car.h里只是做了class Engine;的前向声明，然后定义class Car { Engine* engine; };，那你包含Car.h后，只能声明Engine*或Engine&，不能直接创建Engine对象、调用它的成员——因为编译器只知道Engine是个类，不知道它的具体结构。
• 只有当Car.h里直接包含了Engine.h，你引入Car.h后才能直接使用Engine的所有功能。但这种做法容易触发循环包含，所以头文件里优先用前向声明减少依赖，把具体的#include放到.cpp文件里。

四、解决你当前的错误与循环包含问题 #

你的报错大概率是依赖逻辑混乱导致的，按以下步骤排查：

1. 打破循环包含：把其中一个头文件的#include换成前向声明。比如头文件1包含头文件2，那头文件2里不要#include头文件1，改用class Class1;声明，然后在头文件2对应的.cpp文件里再#include头文件1。
2. 添加头文件保护：给每个头文件加上保护，防止重复包含，示例：

#ifndef CAR_H
#define CAR_H
// 头文件内容
#endif // CAR_H

也可以用#pragma once（主流编译器都支持）。
3. 排查成员访问失败问题：如果某个文件无法访问类成员，先检查有没有包含对应头文件——是不是只用了前向声明却试图访问类的具体内容，或是头文件保护写错导致头文件没被正确引入。

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