如何正确地在C语言项目中编写和使用头文件？

在C语言项目中，头文件（header files）是用来包含函数声明、宏定义或结构体定义等公共信息的文件。它们允许你在程序的不同源文件中复用代码，提高代码的组织和维护性。以下是编写和使用头文件的一些基本步骤：

1. **创建头文件**：通常，将需要共享的部分命名成`.h`文件，例如`example.h`。在文件中，写下所需公开的内容，如函数原型（函数名和参数列表）、结构体声明等。

// example.h
#ifndef EXAMPLE_H
#define EXAMPLE_H

// 函数原型
int add(int a, int b);

// 结构体声明
typedef struct {
    int value;
} ExampleStruct;

#endif // EXAMPLE_H

2. **包含头文件**：在需要使用这些内容的源文件（`.c`文件）中，使用`#include`指令引入头文件，确保在使用前已经被预处理器处理过。

// main.c
#include "example.h"

int main() {
    int result = add(5, 7);
    return 0;
}

3. **注意事项**：
- `#ifndef ... #define ... #endif`块用于防止多次包含同一头文件导致的循环依赖（Header Inclusion Guard）。
- 避免在头文件中提供完整的函数实现（除非是纯常量函数），因为这可能会导致链接阶段的二义性问题。
- 使用`extern`关键字可以在头文件中声明变量或函数但在其他文件中定义它们，以便控制其作用域。