C 语言多文件工程与头文件设计
更新时间：2026-08-26。本文是
languages/c/主题高手层的骨架文档（占位），完整展开将在后续批次补齐。
本文要回答的问题
- 一个工程拆成多个
.c/.h，怎么组织才不乱？ #include重复包含怎么办？头文件里放什么？- 模块间怎么共享变量和函数？
一、头文件设计原则
| 放头文件 | 放 .c 文件 |
|---|---|
| 类型定义（struct/typedef/enum） | 函数实现 |
| 函数声明（原型） | 内部辅助函数（static） |
宏、常量、extern 声明 | 局部全局变量（static） |
头文件是接口：只暴露"别人需要知道的东西"，实现细节藏在 .c 里（配合 static）。
二、include guard 与重复包含
每个头文件必须防重复包含，二选一：
c
/* 方式一：#ifndef 经典 */
#ifndef FOO_H
#define FOO_H
/* ... */
#endif
/* 方式二：#pragma once（现代编译器通用） */
#pragma once三、共享变量与循环依赖
- 跨文件共享变量：在头文件里
extern int g_counter;，在一个.c里真正定义。 - 共享函数：头文件放声明、某
.c放实现，链接时解析，见 编译与链接全过程。 - 循环依赖（A.h include B.h、B.h include A.h）：用前向声明（
struct B;）+ 指针减少头文件耦合。
四、Makefile 组织
makefile
CC = gcc
CFLAGS = -O0 -g -Wall -Wextra
OBJS = main.o module.o util.o
app: $(OBJS)
$(CC) -o $@ $^增量编译：改一个 .c 只重编它自己——编译单元化是构建速度的关键。本站 demos 的 Makefile 就是范例（make/make release）。
五、与入门层的衔接
一句话总结
多文件工程的本质是"接口与实现分离"：头文件只放接口 + include guard + extern 声明，static 锁住实现细节，Makefile 管增量编译——模块化才立得住。
本文为骨架文档：核心结构已就位，示例代码与实测数据将在后续批次补齐。