从第一次在头文件里写 static int counter = 0; 开始,我就隐约觉得哪里不对劲:头文件明明被好几个 .c 文件 #include 了,但编译链接一点错都不报;可运行起来之后,这个 counter 的状态就像“分身”一样,各改各的。后来我用 gcc -E 看预处理输出、用 nm 翻符号表、再打印运行时的地址,才彻底想明白——static 和 #include 之间的相互作用,本质上就是“文本复制”和“翻译单元隔离”这两件事叠加的结果。这篇实验报告就把当时搭的最小复现环境、对比实验和踩坑结论完整记录下来,适合所有正在用 C 语言做多文件工程、或者对“头文件里到底能不能定义 static 变量”心存疑惑的开发者。
1. 一个反直觉的起点:#include 把代码“原样粘贴”而非“引用进符号表”
1.1 预处理输出里的真相
很多初学者(包括当年的我)会把 #include 理解成类似 Java import、Python import 的机制——好像头文件里写的东西被“引用”进当前文件,用到了才去解析。但实际上 C 语言的 #include 只是一个文本替换指令,发生在编译的最早阶段(预处理阶段),机制上简单粗暴:把被包含文件的全部内容,逐字复制到 #include 语句所在的位置。
我们做一个最小验证。假设我有两个文件:
c复制// shared.h
#ifndef SHARED_H
#define SHARED_H
int add(int a, int b) {
return a + b;
}
#endif
c复制// main.c
#include "shared.h"
int main(void) {
return add(1, 2);
}
对 main.c 执行预处理,不进行实际编译:
bash复制gcc -E main.c -o main.i
打开生成的 main.i,你会看到原来的 #include "shared.h" 那一行已经不在了,取而代之的是一整段从 shared.h 里复制进来的代码:
c复制# 1 "main.c"
# 1 "shared.h"
# 1 "<built-in>"
# 1 "<command-line>"
#ifndef SHARED_H
#define SHARED_H
int add(int a, int b) {
return a + b;
}
#endif
# 1 "main.c"
int main(void) {
return add(1, 2);
}
注意,add 函数的定义是完整“贴”进来的。这不是“引入一个符号引用”,而是把函数实现、变量定义全部变成了当前文件的一部分。
1.2 “文本复制”这个性质,决定了后面的一切
把 #include 理解成文本复制之后,一个关键的推论自然出现了:每一个包含某头文件的 .c 文件,都会在各自独立的预处理过程中,得到一份完全独立的头文件代码副本。也就是说:
main.c预处理后,有一份shared.h的代码;unit_a.c预处理后,也有一份一模一样的shared.h代码;unit_b.c预处理后,还有一份一模一样的shared.h代码。
这三份代码虽然内容相同,但它们已经分别属于三个不同的“翻译单元”(translation unit)。翻译单元可以粗略理解为“一个 .c 文件经过预处理展开后的完整源码”。后续编译、符号解析、链接,都是以翻译单元为单位进行的。
所以,如果你在头文件里写了一个 static 变量,那么“static”这个关键字施加的作用范围,不是“整个工程”,而是“当前这一个翻译单元”。头文件被多少个 .c 文件包含,这个 static 变量就会同时在多少个翻译单元里被定义一份。至于为什么这些同名定义不会互相冲突,那是链接器层面的问题,后面单独用一节来讲。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. static 的三种面孔:局部变量、文件级变量,以及链接性差异
2.1 函数内部的 static:改变存储期,不改变作用域
先看最常见的一种:
c复制int next_id(void) {
static int id = 0;
return id++;
}
这里的 static 改变的是变量 id 的存储期(storage duration)。原本一个局部变量在函数调用结束后生命周期就结束;加上 static 后,它被放到静态存储区,生命周期延长到整个程序运行期间,但它的作用域依然是 next_id 函数内部。外部代码无法通过名字访问它,也没法通过链接器符号引用它。
这类 static 变量和 #include 的相互作用相对温和,只有一种情况需要特别警惕:如果你在头文件里定义了一个 static inline 函数,而这个函数内部又有一个 static 局部变量,那么每个包含这个头文件的翻译单元,都会各自拥有一份独立函数和独立局部变量。后文对比实验里会展示这个场景。
