C语言头文件是后缀为.h的文件，主要用于存放函数声明、宏定义、结构体、枚举等类型定义以及全局变量声明，是连接不同源文件的重要桥梁，合理的头文件编写能让多文件项目编译更顺畅。
头文件的核心作用
头文件的核心作用是向编译器提供声明信息，让编译器在编译源文件时知道函数、变量、类型的存在和具体格式，不需要知道具体的实现细节。当多个源文件需要使用同一个函数或者同一个结构体时，只需要包含对应的头文件即可，不需要重复编写声明内容。
头文件的基本结构
一个规范的头文件通常包含以下几个部分，其中防止重复包含的预处理指令是必须添加的内容。
1. 防止重复包含的预处理指令
如果一个头文件被同一个源文件多次包含，或者多个头文件互相包含，就可能出现函数、类型重复定义的问题，因此需要添加防止重复包含的预处理指令。常见的写法有两种，一种是使用#ifndef配合#define和#endif，另一种是使用#pragma once。
使用#ifndef的写法兼容性更好，示例代码如下：
#ifndef __TEST_H__ // 如果没有定义__TEST_H__宏 #define __TEST_H__ // 定义__TEST_H__宏 // 头文件的具体内容写在这里 #endif // 结束条件编译
使用#pragma once的写法更简洁，但是部分非常老旧的编译器可能不支持，示例代码如下：
#pragma once // 告诉编译器只编译一次这个头文件 // 头文件的具体内容写在这里
2. 函数声明
头文件中只需要放函数的声明，不需要放函数的实现，函数的实现要放在对应的.c源文件中。函数声明需要包含函数的返回值类型、函数名、参数类型和参数名（参数名可以省略，但建议写上方便理解）。
示例函数声明如下：
// 计算两个整数的和，返回结果 int add(int a, int b); // 打印传入的字符串内容 void print_str(const char *str);
3. 宏定义
头文件中可以存放常用的宏定义，比如常量宏、函数式宏等，方便多个源文件共同使用。需要注意函数式宏要加足够的括号避免运算优先级问题。
示例宏定义如下：
// 定义圆周率常量 #define PI 3.1415926 // 计算两个数中较大的一个，加括号避免优先级问题 #define MAX(a, b) ((a) > (b) ? (a) : (b))
4. 类型定义
如果多个源文件需要使用同一个结构体、枚举、联合体或者自定义类型，就可以把这些类型的定义放在头文件中。
示例类型定义如下：
// 定义学生结构体类型
typedef struct {
int id; // 学生id
char name[20]; // 学生姓名
float score; // 学生成绩
} Student;
// 定义颜色枚举类型
typedef enum {
RED, // 红色
GREEN, // 绿色
BLUE // 蓝色
} Color;
5. 全局变量声明
如果需要在多个源文件中使用同一个全局变量，不能在头文件中直接定义全局变量，否则多个源文件包含这个头文件时会出现重复定义错误。正确的做法是在头文件中用extern关键字声明全局变量，然后在对应的一个.c源文件中定义这个全局变量。
示例全局变量声明如下：
// 声明全局变量，记录系统运行次数 extern int run_count;
对应的.c源文件中定义：
// 定义全局变量，初始化为0 int run_count = 0;
头文件的编写注意事项
- 头文件中不要放函数的具体实现，函数的实现要放在.c源文件中，否则多个源文件包含这个头文件时会出现函数重复定义的错误。
- 头文件的名称要和对应的源文件名称保持一致，比如源文件是test.c，对应的头文件可以命名为test.h，方便管理。
- 包含头文件时，系统头文件用< >包裹，自定义头文件用" "包裹，比如
#include <stdio.h>是包含系统标准输入输出头文件，#include "test.h"是包含自定义的test.h头文件。 - 不要在头文件中使用
using namespace std这类C++的语法，C语言不支持命名空间。 - 头文件中的声明要和对应的.c源文件中的定义保持一致，比如函数声明的参数类型、返回值类型和函数定义要完全匹配，否则会出现编译错误。
完整头文件示例
下面是一个完整的test.h头文件示例，包含了上述提到的所有规范内容：
#ifndef __TEST_H__
#define __TEST_H__
#pragma once // 两种方式可以同时使用，兼容性更好
#include <stdio.h> // 包含需要的系统头文件
// 宏定义
#define PI 3.1415926
#define MAX(a, b) ((a) > (b) ? (a) : (b))
// 类型定义
typedef struct {
int id;
char name[20];
float score;
} Student;
// 全局变量声明
extern int run_count;
// 函数声明
int add(int a, int b);
void print_str(const char *str);
float calc_circle_area(float radius);
#endif
对应的test.c源文件实现如下：
#include "test.h"
// 定义全局变量
int run_count = 0;
// 实现add函数
int add(int a, int b) {
return a + b;
}
// 实现print_str函数
void print_str(const char *str) {
printf("%sn", str);
}
// 实现calc_circle_area函数
float calc_circle_area(float radius) {
return PI * radius * radius;
}
其他源文件如果需要使用test.h中的内容，只需要包含这个头文件即可，比如main.c的写法如下：
#include "test.h"
int main() {
run_count++;
int sum = add(10, 20);
printf("sum is %dn", sum);
print_str("hello world");
Student stu = {1, "张三", 95.5};
printf("student name is %sn", stu.name);
return 0;
}