在C语言里，头文件是指以.h作为扩展名的文本文件，它本身不是可编译的独立程序，而是用来存放声明信息的容器。当我们写代码时，通过预处理指令把头文件的内容包含进来，编译器就能提前知道某些函数、变量或者类型的存在形式，从而顺利完成语法检查和后续的编译链接。
头文件的本质与预处理机制
从底层来看，C语言程序在真正编译之前会经历一个预处理阶段。预处理器遇到以#开头的指令就会执行对应操作，其中#include的作用非常直接：它把指定文件里的全部文本内容，原封不动地复制到当前源文件指令所在的位置。也就是说，头文件并不是被“调用”或者“运行”的，而是被“拼接”进代码里的。
这种文本替换机制意味着，如果我们在header.h中写了一个函数声明，那么在main.c里写#include "header.h"之后，就等同于把那段声明手工敲在了main.c对应位置。正因为只是文本插入，头文件里一般只放声明而不放具体实现，否则同一个函数实现被多个源文件包含后，在链接阶段就会出现重复定义的错误。
// math_ops.h
#ifndef MATH_OPS_H
#define MATH_OPS_H
int add(int a, int b); // 仅声明，不写函数体
#endif
// main.c
#include <stdio.h>
#include "math_ops.h"
int main() {
int result = add(3, 4);
printf("result=%dn", result);
return 0;
}
头文件里通常放什么内容
头文件的主要职责是“告知接口”，因此它适合存放函数原型、宏定义、结构体与联合体的类型定义，以及外部变量的声明。比如标准库中的<stdio.h>就声明了printf、scanf等函数，并定义了FILE这样的类型，让我们在写文件操作代码时无需关心底层实现。
需要区分的是，变量如果只是声明（例如用extern修饰），可以放在头文件里供多个文件引用；但变量定义（即分配实际内存）应放在.c文件里。同样，inline函数或static函数由于具有内部链接属性，有时也会直接写在头文件中，这是为了避免链接冲突，但初学者前期最好先遵守“头文件只声明”的原则。
- 函数原型：告诉编译器参数和返回类型
- 宏定义：用#define提供常量或简单替换逻辑
- 类型定义：struct、typedef、enum等供多文件共用
- 外部声明：extern int g_count; 这类全局量引用
防止重复包含的防护写法
由于一个头文件可能被多个其他头文件间接包含，同一份声明如果出现在同一个源文件两次，就会引发重定义报错。为了解决这个问题，工程上普遍使用“头文件守卫”，也就是用宏判断来阻断重复展开。
常见的写法是在头文件最开头定义某个唯一宏，若已定义就跳过后续内容。除了传统的#ifndef方式，部分编译器也支持#pragma once指令，它能达到类似效果且写法更简单，不过为了跨平台兼容，很多开源项目仍习惯使用宏守卫。
// safe.h #ifndef SAFE_H #define SAFE_H void do_something(void); #endif
系统头文件与用户头文件的区别
在写#include时，我们会看到两种写法：尖括号和双引号。使用尖括号如<stdio.h>，预处理器会到系统指定的标准路径去寻找，这通常对应编译器自带的库目录；而双引号如"my_lib.h"，编译器先在当前源文件所在目录找，找不到再去系统路径搜。
这个差别决定了我们在引用自己写的模块时应使用双引号，引用语言标准库或第三方安装库时使用尖括号。如果弄反了，虽然某些环境仍能编译过，但会降低可读性，也可能在复杂项目中导致找错文件版本。
| 写法 | 搜索顺序 | 典型用途 |
|---|---|---|
| #include <file.h> | 系统目录优先 | 标准库、框架库 |
| #include "file.h" | 当前目录优先 | 项目内自定义头文件 |
常见误区与实践建议
不少新手以为头文件里能直接写业务逻辑，结果把函数体全塞进.h，被多个.c包含后链接失败。正确做法是把实现挪到同名的.c文件，头文件保持干净。另外，有人喜欢在头文件里使用全局变量定义，这也会造成多文件链接时报重复符号，应当改为extern声明加单点定义。
从工程角度，建议每个模块都配一对.c和.h，头文件充当契约，.c负责落地。当项目变大时，这种分离能显著降低耦合，也方便做单元测试和替换实现。理解头文件不是魔法，只是预处理阶段的文本合并，就能更从容地组织C语言代码。
头文件是C语言模块化设计的门槛，跨过它，才真正开始写“像样”的工程代码。