头文件引入（#include）

1.基本功能

#include是C++ 预处理器指令，用于在编译前将指定文件的内容插入到当前源文件中。

2.核心作用：

声明共享：允许不同源文件访问相同的函数声明、类定义、常量等。

代码复用：避免重复定义，减少冗余代码。

模块化：将程序分解为逻辑单元。

标准库支持：提供标准功能接口（如 I/O、容器等）。

3.语法格式

#include <header> // 系统/标准库头文件 #include "header.h" // 用户自定义头文件

尖括号 <>：优先在系统目录搜索（如 /usr/include, C:\MinGW\include）。

双引号 ""：先在当前目录搜索，再到系统目录搜索。

4.工作原理（编译流程）

5.关键用法

(1)标准库引入

#include <iostream> // I/O 操作 #include <vector> // 动态数组容器 #include <algorithm> // 算法函数

(2)自定义头文件

// math_utils.h

#pragma once double add(double a, double b); // 函数声明

// main.cpp

#include "math_utils.h" // 插入声明 int main() { add(2.5, 3.7); // 使用函数 }

(3)防止重复包含

// 方式1：预处理守卫（标准）

#ifndef MATH_UTILS_H #define MATH_UTILS_H /* 头文件内容 */ #endif

// 方式2：#pragma once（编译器扩展，简洁）

#pragma once /* 头文件内容 */

6.常见错误与解决方案

7.最佳实践

(1)头文件内容限制：

只包含声明（函数原型、类定义、extern 变量）。

禁止定义非内联函数（除非 static）。

模板实现需在头文件中。

// 正确示例：头文件声明

class MyClass { public: void doSomething(); // 仅声明 };

(2)包含顺序规范：

// 1. 当前源文件对应的头文件 #include "myclass.h" // 2. C系统头文件 #include <cstdio> // 3. C++标准库头文件 #include <vector> // 4. 第三方库头文件 #include <boost/any.hpp> // 5. 项目其他头文件 #include "utils.h"

8. 底层原理

预处理阶段执行文本替换，编译器只看到单个展开的翻译单元。

示例展开过程：

// main.cpp 原始内容

#include "header.h"

int main() { return 0; }

// 预处理后

/* header.h 内容 */

int main() { return 0; }